Задать вопрос
  • Как правильно именовать сложные действия в REST API?

    @napa3um
    Использование различных пользовательских параметров для осуществления действий совершенно не соответствует идеологии REST (несмотря на всю её абстрактность у неё есть вполне конкретные практические предпосылки), чревато проблемами будущей поддержки и масштабирования. В урле должен быть адрес _ресурса_, а действие с ресурсом должно выражаться стандартным HTTP-глаголом по работе с ресурсом. Тогда и поведение браузера будет логичным (отличие GET от POST там не просто так), и коды ошибок можно использовать стандартные (которые тоже придуманы исходя из "ресурсной" терминологии/идеологии), и механизмы кеширования будут задействованы правильно (т.к. менять объекты могут только "избранные" глаголы, а урл строго соответствует ресурсу вне зависимости от осуществляемого действия), и документация API будет гораздо компактнее (т.к. не будет описывать новые логики относительно REST). Если нужны нестандартные действия - вырази их в форме новых подчинённых ресурсов (например, представляя их "квитанциями об операции", в стиле документооборота), с которыми работают всё те же стандартные глаголы REST.