Skip to main content

Введение

Это руководство охватывает все возможные коды ответов, форматы ошибок и лучшие практики обработки ошибок при интеграции с 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

Режим Обслуживания:

🔄 Стратегии Повтора

Рекомендуемая Логика Повтора


📝 Лучшие Практики

Чек-лист Обработки Ошибок

Валидация Перед Запросом
  • Валидировать формат номера телефона
  • Проверять обязательные поля
  • Валидировать формат даты/времени
  • Проверять существование шаблона
Мониторинг Запросов
  • Логировать все API-запросы
  • Включать request_id в логи
  • Мониторить время ответа
  • Отслеживать частоту ошибок
Восстановление Ошибок
  • Реализовать соответствующую логику повтора
  • Кешировать токены аутентификации
  • Элегантно обрабатывать ограничения скорости
  • Предоставлять значимые сообщения об ошибках пользователям
Пользовательский Опыт
  • Показывать понятные сообщения об ошибках
  • Предоставлять полезную обратную связь
  • Не раскрывать внутренние детали ошибок
  • Предлагать альтернативы при возможности
Помните, всегда включать request_id при обращении в поддержку для более быстрого разрешения проблем.