Привет, Хабр! Представляю вашему вниманию перевод статьи "
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.
Пагинация
6.
Использование SSL
7.
HTTP методы
8.
Эффективное использование кодов ответов HTTP
