Основы проектирования API
REST, коды ответов, версионирование и консистентность ошибок.
Хороший API предсказуем: единый стиль URL, осмысленные коды ответов и форматы ошибок.
Рекомендации
- Используй правильные HTTP-методы и коды (200, 201, 400, 404, 500)
- Версионируй через URL (
/v1/...) или заголовок - Ошибки возвращай в одном формате:
{ error: string, code?: string }