Введение
Это руководство охватывает все возможные коды ответов, форматы ошибок и лучшие практики обработки ошибок при интеграции с API Lovi.📊 HTTP-Коды Статуса
Успешные Ответы
200 OK - Запрос Успешен
Уведомление Обработано:Ответы Ошибок Клиента (4xx)
400 Bad Request - Недопустимые Параметры
Отсутствует Обязательное Поле:401 Unauthorized - Ошибка Аутентификации
Недопустимый Ключ Доступа:403 Forbidden - Доступ Запрещен
Недостаточные Разрешения:404 Not Found - Ресурс Не Найден
Шаблон Не Найден:422 Unprocessable Entity - Ошибка Логики Бизнеса
Шаблон Не Утвержден:429 Too Many Requests - Превышен Лимит Скорости
Достигнут Лимит:Ответы Ошибок Сервера (5xx)
500 Internal Server Error
Общая Ошибка Сервера:502 Bad Gateway
Ошибка Сервиса Upstream:503 Service Unavailable
Режим Обслуживания:🔄 Стратегии Повтора
Рекомендуемая Логика Повтора
| Код Статуса | Действие | Стратегия Повтора |
|---|---|---|
400, 404, 422 | ❌ Не повторять | Исправить запрос и попробовать снова |
401, 403 | ❌ Не повторять | Обновить аутентификацию |
429 | ⏰ Повторить с задержкой | Использовать заголовок retry_after |
500, 502, 503 | 🔄 Повторить с экспоненциальной задержкой | Макс 3 попытки |
📝 Лучшие Практики
Чек-лист Обработки Ошибок
✅ Валидация Перед Запросом- Валидировать формат номера телефона
- Проверять обязательные поля
- Валидировать формат даты/времени
- Проверять существование шаблона
- Логировать все API-запросы
- Включать request_id в логи
- Мониторить время ответа
- Отслеживать частоту ошибок
- Реализовать соответствующую логику повтора
- Кешировать токены аутентификации
- Элегантно обрабатывать ограничения скорости
- Предоставлять значимые сообщения об ошибках пользователям
- Показывать понятные сообщения об ошибках
- Предоставлять полезную обратную связь
- Не раскрывать внутренние детали ошибок
- Предлагать альтернативы при возможности
request_id при обращении в поддержку для более быстрого разрешения проблем.