restapi
-
Rest api: Основные принципы
•
1 минута прочитано
🚀 Спорите с коллегами о структуре API? Собрал основные принципы и правила, которые часто нарушают или пренебрегают, вызывают холивар! Чек-лист главных правил для ручек (endpoint): как называть, куда «класть» методы HTTP и избегать типичных косяков. Читайте и проектируйте API с уверенностью 😊
-
Правила названий ручек (endpoint)
•
1 минута прочитано
Здесь собраны основные правила нейминга ручек со ссылками на первоисточник. В роли первоисточника — RFC документ. 1. Основные правила структуры URI 2. Рекомендации по читаемости 3. Паттерны для параметров: 4. Лучшие практики Примеры правильного нейминга: Неправильно Правильно /getUser /users/{id} /updateOrder /orders/{id} (метод PUT) /api/get_all_posts /api/v1/posts Как искать на RFC Editor: Я привел наиболее часто используемые правила, которые встречаю в своей…
-
Stateless и Statefull на пальцах
•
2 минуты прочитано
Скучная теория: В RestAPI интеграциях есть основные принципы, один из них — это stateless rest api принцип. В скучной теории, определение этого принципа гласит, что stateless в клиент- серверной архитектуре — это когда сервер не хранит информацию о состоянии клиента. Но что это значит в техническом плане? Как препарировать это простое определение? В своих объяснениях,…
