У меня есть URL-адрес для получения встреч для пользователя следующим образом:
/user/:userId/appointments
Как должен выглядеть URL-адрес, если я хочу назначить встречи для нескольких пользователей?
должно ли быть:
/appointments?users=1d1,1d2..
Спасибо, Крис.
Коллекции — это ресурс, поэтому /appointments подойдет в качестве ресурса.
Коллекции также обычно предлагают фильтры через строку запроса, которая, по сути, является пользователями = id1, id2....
So,
/appointments?users=id1,id2
подходит как отфильтрованный ресурс RESTful.
Я думаю, что лучше сериализовать параметры вызова REST, обычно путем их JSON-кодирования:
/appointments?users=[id1,id2]
или даже:
/appointments?params={users:[id1,id2]}
Затем вы раскодируете их на сервере. Это даст вам больше гибкости в долгосрочной перспективе.
Просто не забудьте URLEncode параметры, прежде чем отправлять их!
Другой способ сделать это, который может иметь смысл в зависимости от выбранной вами серверной архитектуры/фреймворка, состоит в повторении одного и того же аргумента снова и снова. Что-то вроде этого:
/appointments?users=id1&users=id2
В этом случае я рекомендую использовать имя параметра в единственном числе:
/appointments?user=id1&user=id2
Это изначально поддерживается такими фреймворками, как Jersey (для Java). Взгляните на этот вопрос для получения дополнительной информации. подробности.
/appointments?users=1d1,1d2..
Это хорошо. Это в значительной степени ваш единственный разумный вариант, поскольку вы не можете передать тело с помощью GET.
Это сработало для меня.
/users?ids[]=id1&ids[]=id2
Вместо использования http GET используйте http POST. И JSON. Или XML
Вот как будет выглядеть ваш поток запросов к серверу.
POST /appointments HTTP/1.0
Content-Type: application/json
Content-Length: (calculated by your utility)
{users: [user:{id:id1}, user:{id:id2}]}
Или в XML,
POST /appointments HTTP/1.0
Content-Type: application/json
Content-Length: (calculated by your utility)
<users><user id='id1'/><user id='id2'/></users>
Вы, конечно, могли бы продолжать использовать GET, как вы предложили, так как это, безусловно, проще.
/appointments?users=1d1,1d2
Это означает, что вам нужно будет сделать свои структуры данных очень простыми.
Однако, если/когда ваша структура данных становится более сложной, http GET и без JSON, ваше программирование и способность распознавать данные становятся очень трудными.
Поэтому, если вы не можете сохранить свою структуру данных простой, я настоятельно рекомендую вам принять структуру передачи данных. Если ваши запросы основаны на браузере, обычной практикой в отрасли является JSON. Если ваши запросы сервер-серверные, то XML — самый удобный фреймворк.
JQuery
Если вашим клиентом является браузер и вы не используете GWT, вам следует рассмотреть возможность использования jquery REST. Google в службах RESTful с jQuery.
