Рекомендации по созданию веб-служб RESTful содержит всю информацию о необходимых вам ресурсах.
Это еще одна полезная запись в блоге :
Унифицированные ограничения интерфейса описывают, как сервис, созданный для Интернета, может быть хорошим участником веб-архитектуры. Эти ограничения кратко описаны следующим образом:
1) Идентификация ресурсов: ресурс - это любой информационный элемент, который может быть назван и представлен (например, документ, цена акций в определенный момент времени, текущая погода в Лас-Вегасе и т. Д.). Ресурсы в вашем сервисе должны быть идентифицированы с использованием URI.
2) Управление ресурсами с помощью представлений. Представление - это физическое представление ресурса, которое должно соответствовать действительному типу носителя. Использование стандартных типов мультимедиа в качестве форматов данных, лежащих в основе вашего сервиса, расширяет охват вашего сервиса, делая его доступным для широкого круга потенциальных клиентов. Взаимодействие с ресурсом должно основываться на извлечении и манипулировании представлением ресурса, идентифицированным его URI.
3) Сообщения с самоописанием. Следуя принципам отсутствия состояния во взаимодействиях вашей службы, используя стандартные типы мультимедиа и правильно указывая кэшируемость сообщений с помощью использования метода HTTP и контрольных заголовков, вы обеспечиваете информативность сообщений. Сообщения с самоописанием позволяют обрабатывать сообщения посредниками между клиентом и сервером, не оказывая влияния ни на одно из них.
4) Гипермедиа как движок состояния приложения: состояние приложения должно быть выражено с использованием URI и гиперссылок для перехода между состояниями. Это, пожалуй, наиболее противоречивый и наименее понятный из архитектурных ограничений, изложенных в диссертация Роя Филдинга . На самом деле, диссертация Филдинга содержит явные аргументы против использования файлов cookie HTTP для представления состояния приложения, чтобы уловить этот вопрос, но часто игнорируется.