diagnostics
Ошибки 401 / 429 / 502
Короткая расшифровка ответов релея. Тексты сообщений и секреты в поддержку присылать не нужно: достаточно статуса, метода и ID записи из журнала.
| код | причина | что сделать |
|---|---|---|
| 401 unauthorized | Нет заголовка X-API-Key, ключ неверный или отозван. | Создайте новый ключ в панели и передайте его в заголовке X-API-Key. |
| 429 rate limit exceeded | Слишком много запросов в минуту с одного API-ключа. | Добавьте retry/backoff, снизьте burst или распределите нагрузку. |
| 429 quota exceeded | Закончился дневной или месячный лимит тарифа. | Проверьте usage в панели, дождитесь нового периода или смените тариф. |
| 502 upstream unavailable | Telegram Bot API или сеть до upstream не ответили вовремя. | Повторите запрос позже. Если повторяется, откройте лог и пришлите ID записи в поддержку. |
| 413 body too large | Тело запроса больше лимита релея. | Уменьшите payload или отправляйте медиа способом, совместимым с Telegram Bot API. |
Как диагностировать
- Проверьте статус релея.
- Откройте журнал запросов в панели и найдите метод/статус.
- Проверьте, что API-ключ активен и передаётся именно в
X-API-Key. - Для 429 откройте usage и текущий тариф.
- Для 502 повторите запрос с backoff и сохраните ID лога.