Имеется сайт на одном небольшом mvc фреймворке php. Там нет готовых кейсов для реализации API, поэтому пришлось изобретать свой велосипед
Итак, имеется контроллер. Он обрабатывает все запросы по сайт.ру/api/...
В этом контроллере есть, например, раздел getUserById (сайт.ру/api/getUserById), который принимает входящие post или get параметры запроса. Мы обрабатываем эти параметры и рендерим json.
Является ли такая реализация rest api?
Знаю, в rest api есть такие методы, как post, put, delete, get. Но у меня эти методы реализованы через post/get параметры. Нормально ли это?
API - application programming interface
Так что является в полной мере.
Насчет put и delete не волнуйтесь, обыкновенная практика передавать параметр method=put,delete
Бывает что веб сервер их просто не поддерживает.
Ну вы сами ответили на свой вопрос. В RESTful - методологии для каждой сущности должна быть реализация CRUD. На одном URL, отличаются только HTTP-методы:
POST /api/users (create)
GET /api/users/1 (read)
PUT /api/users/1 (update)
DELETE /api/users/1 (delete)
Если хотите именно REST-архитектуру, почитайте что-то вроде этого. Тогда уже станет понятно, нужна ли вам такая реализация или хватит текущей.
И кроме реализации запросов должны быть и другие слои: авторизация (токены / bearer / ip), кеширование и т.д.
В RESTful - методологии для каждой сущности должна быть реализация CRUD
Нету в REST ничего про CRUD.
Можете грепом пройтись по диссертации, если не верите.
Vadim Stepanenko, для API важно удобство для клиентов, и, вероятно, для разработчиков.
Использовать только get/post не проблема. Просто разберитесь как различается обработка этих запросов (то есть ознакомьтесь минимально со спецификацией или статьями какими про http).
Евгений Ромашкан, ну вообще под RESTful подразумевается реализация под HTTP, отсюда и GET/PUT/PATCH/POST/DELETE/OPTIONS. Но вообще да, RESTful не накладывает на это никаких ограничений.
