[Из песочницы] REST API Best Practices


Автор: AntonShtabnoy
Источник: https://habrahabr.ru/post/351890/
Привет, Хабр! Представляю вашему вниманию перевод статьи "REST API Best Practices" автора Krishna Srinivasan.

REST становится общим подходом для представления сервисов окружающему миру. Причина его популярности заключается в его простоте, легкости использования, доступе через HTTP и другие. Существует неправильное представление о том, что все данные, доступные через сеть, считаются REST, но это не так. В этой статье я собираюсь объяснить вам некоторые best practices, которые вы должны всегда помнить при реализации собственного REST приложения. Я бы хотел услышать ваш опыт в REST приложениях, поэтому если вы знаете best practies, которые не упомянуты в этой статье, пожалуйста, поделитесь с нами в комментариях.

Disclamer: все best practies основаны на моем личном опыте. Если вы имеете другое мнение, не стесняйтесь отправлять его мне на email, и мы обсудим его.

Здесь представлен список best practices, которые будут обсуждаться в этой статье:


  1. Конечные точки в URL – имя существительное, не глагол
  2. Множественное число
  3. Документация
  4. Версия вашего приложения

    5. Пагинация

  5. Использование SSL
  6. HTTP методы
  7. Эффективное использование кодов ответов HTTP
    Читать далее


Comments 0