Sobes.tech
Back to questions
Junior — Middle
66

Какие стандарты и соглашения по именованию ресурсов и эндпоинтов применяются в REST API?

Answer from AI

sobes.tech AI

В REST API принято придерживаться следующих стандартов и соглашений по именованию ресурсов и эндпоинтов:

  • Использовать существительные во множественном числе для ресурсов, например /users, /orders.
  • Использовать строчные буквы и дефисы для разделения слов: /user-profiles.
  • Для получения ресурса использовать GET, для создания POST, для обновления PUT/PATCH, для удаления DELETE.
  • Идентификаторы ресурсов указываются в пути, например /users/123.
  • Для вложенных ресурсов использовать иерархию: /users/123/orders.
  • Не использовать глаголы в путях, действия выражаются HTTP-методами.

Пример:

GET /products - получить список продуктов
POST /products - создать новый продукт
GET /products/45 - получить продукт с id=45
PUT /products/45 - обновить продукт
DELETE /products/45 - удалить продукт

Соблюдение этих правил делает API понятным и удобным для использования.