#0 Credit cookie ~ ∞

Credit cookie — A short clip that appears during or after the closing credits of a film or video game, typically either humorous or setting up a possible sequel.

• Имена ресурсов должны быть во множественном числе (мы оперируем коллекциями):
  • WRONG: GET /group/3/user/4
  • RIGHT: GET /groups/3/users/4
  
  
• Организуем ресурсы от большего к меньшему:
  • WRONG: GET /books/123/authors/8/categories/1
  • RIGHT: GET /categories/1/authors/8/books/123
  
  
• Никаких глаголов в наименовании ресурсов — для этого есть глаголы (методы) HTTP;
  Не используем заглавные буквы, а если очень нужно используем -;
  Фильтры и сортировка передаются через параметры запроса (query parameters):
  • WRONG: GET /articles/listArticles/sortByNew
  • RIGHT: GET /articles?sort=date,asc
  
  
• Правильно используем HTTP глаголы (вспоминаем):
  • WRONG: POST /accounts/4402278/delete
  • WRONG: POST /deleteAccount?accountNumber=4402278
  • RIGHT: DELETE /accounts/4402278
  
  
• Правильно используем коды ошибок HTTP (снова вспоминаем).
  Код ошибки сообщает потребителю статус ответа. Нужно быть осторожными при выборе кодов состояния – они должны точно отражать то, что произошло на стороне сервера.
  • WRONG: GET /accounts/123456
    (записей не найдено) ответ: HTTP status 200 (ok) с телом сообщения, в котором написано, что мы ничего не нашли
  • RIGHT: GET /accounts/123456
    (записей не найдено) ответ: HTTP status 404 (not found)