Ответы пользователя по тегу RESTful API
  • Как тут лучше сделать роутинг для POST запроса?

    @napa3um
    Обе схемы приемлемы, выбор зависит от способа использования вашего API. Подозреваю, что в вашем приложении предполагается навигация по всему списку устройств вне зависимости от привязанного к нему пользователя. Получается, что первый вариант более подходящий, он позволит вам иметь отдельный REST-ресурс для вывода и манипуляций устройствами вне привязки к пользователю.
    Ответ написан
    Комментировать
  • Как правильно именовать сложные действия в REST API?

    @napa3um
    В идеологии REST нужно мыслить с точки зрения декомпозиции предметной области задачи на объекты-ресурсы (с соответствующими урлам), а глаголы (действия) строго фиксированные (закреплённые, в том числе, в протоколе HTTP). Этим достигается масштабируемость (во всех смыслах) разрабатываемого веб-сервиса. Если в прикладной области видится большое разнообразие действий, а не объектов, то их можно воспринимать в стиле документов документооборота или транзакций платёжной системы. Например, пуск ракеты по стране можно представить в виде создания документа (транзакции) "пуск ракеты по стране". Оформить можно и как вложенный в ракету ресурс, и как корневой ресурс с атрибутами "ракета" и "страна", - это зависит от физической и логической организации сервиса. Такой ресурс-документ можно снабдить идентификатором и дать ему возможность обрабатываться на любом сервере, входящем в инфраструктуру веб-сервиса, читать из него автоматически сгенерированные атрибуты типа "время запуска", "статус полёта", т.п. В общем, основная идея комментария: мыслить в терминах документооборота, и сервис получится логичным, поддерживаемым, масштабируемым, как и задумано REST'ом.
    Ответ написан
    Комментировать