REST, как обрабатывать параметры запроса при помещении в ресурс?

Question

У меня есть служба данных REST, где я хочу разрешить пользователям создавать новые элементы с помощью HTTP PUT, используя различные форматы, такие как json, xml, csv. Я не уверен, как лучше всего обрабатывать спецификацию формата в URL:

PUT /ressource/ID/json
PUT /ressource/ID/xml

или

PUT /ressource/ID?format=json
PUT /ressource/ID?format=xml

Так, как лучше всего указать индикатор формата?

Если я указываю формат с параметром запроса и хочу сделать PUT, как я могу сделать это с помощью curl?

curl -T test/data.json -d "format=json"  http://localhost:5000/resource/33

не работает.

curl -T test/data.json http://localhost:5000/update?format=json

работает, но я бы предпочел, чтобы curl создавал параметры запроса, а не добавлял их сам.

Answer 1

Общий принцип веб-сервисов RESTful - использовать функции, встроенные в HTTP, когда это применимо. В этом случае вы можете указать формат содержимого вашего запроса PUT, установив для заголовка Content-Type значение application / json или application / xml .