классы ошибок интеграции

Классы ошибок интеграции - это группы кодов ответа, по которым определяют источник проблемы и тактику реакции.

Простыми словами: код ошибки подсказывает, что чинить в первую очередь.

Типовые классы:

1. 401 Unauthorized

• Обычно: токен отсутствует, истек или передан в неверном формате.
• Для Метрики: проверить Authorization: OAuth <token> и актуальность токена.

1. 403 Forbidden

• Обычно: токен валиден, но прав недостаточно.
• Для Метрики: проверить доступ к конкретному counter_id.

1. 404 Not Found

• Обычно: неверный endpoint или несуществующий ресурс.
• Для Метрики: проверить путь API и корректность идентификаторов.

1. 409 Conflict

• Обычно: конфликт состояния ресурса/операции.
• Для Метрики: учитывать состояние сущности и ограничения доменной операции (актуально для management/async workflow).

1. 429 Too Many Requests

• Обычно: превышение лимитов частоты/квоты.
• Для Метрики: снизить частоту, добавить backoff, пересмотреть пакетирование.

1. 5xx

• Обычно: временный сбой на стороне сервиса.
• Тактика: повтор с ограничением попыток + фиксация контекста запроса.

Практический вывод:

• Для каждого кода должен быть заранее определен "runbook реакции".
• В Метрике большинство инцидентов на старте связаны с 401/403 (доступ) и 429 (лимиты).