REST API Server

Question

Я часто слышу или читаю термин REST API Server.

Я кодирую с помощью PHP и в прошлом делал API для своих проектов, которые могли возвращать данные в форматах XML и JSON, и они были в форме REST, где вы могли бы сделать что-то вроде

server.com/comments/123 Для возврата / просмотра комментария с идентификатором 123
server.com/comments/post чтобы оставить комментарий
server.com/comments/123/edit для редактирования комментария с идентификатором 123
server.com/comments/123/delete чтобы удалить комментарий с идентификатором 123

Теперь я не считаю этот сервер REST, но я думаю, что это REST?

Может ли кто-нибудь уточнить или объяснить, если я ошибаюсь? Я имею в виду, есть ли еще что-то для REST-сервера, и это просто используемый термин, или REST-сервер полностью отличается от функциональности, которую я описал выше?

У меня скоро будет проект, для которого потребуется RESTful API, поэтому я хотел бы убедиться, что я делаю это правильно.

Answer 1

Подобный вопрос возник недавно: Что такое веб-службы RESTful .Дайте это прочитать.

Кроме того, в Интернете имеется масса информации об отдыхе.Вот один из лучших обзоров, которые я видел: http://www.xfront.com/REST-Web-Services.html.

Короче говоря, ваш сервис не RESTful, но он близок.Вместо того, чтобы указывать действия (редактировать, удалять, ...) в сегментах URL, вам нужно использовать HTTP-глаголы (GET, PUT, POST, DELETE).Эти детали обсуждаются в приведенных ссылках.

Answer 2

Я думаю, что стандарт REST широк, и хотя вы не реализуете собственные методы HTTP, ваш веб-сервис может рассматриваться как сервер REST. Лично я не думаю, что использование пользовательских методов HTTP всегда целесообразно, многим брандмауэрам это не нравится. Я бы реализовал действие (CREATE / DELETE / UPDATE) как часть пути или как часть данных POST (возможно, как свойство JSON).

См. Мое рекомендуемое руководство здесь: http://restafar.com/create-new-rest-server/