• REST API Best Practices

    Привет, Хабр! Представляю вашему вниманию перевод статьи "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
    Читать далее