Краткий ответ
- Корневая причина — автоматический перезапуск контейнера сервиса — в течение окна перезапуска веб-консоль недоступна, а API возвращает 502; это одно и то же событие.
- Восстановление обычно происходит автоматически в течение 1 минуты — подождите 30–60 секунд и повторно отправьте запрос.
- Неудачные вызовы никогда не тарифицируются — во время 502 запрос фактически не доходит до сервиса, поэтому запись о тарификации не создаётся.
- Добавьте автоматические повторные попытки на стороне клиента — одна повторная попытка примерно через 30 секунд без проблем перекроет всё окно перезапуска.
Что происходит
502 Bad Gateway означает: шлюзовой слой получил ваш запрос, но не получил ответа при его пересылке в backend-сервис.
На APIYI подавляющее большинство кратковременных 502 вызвано автоматическим перезапуском контейнера backend-сервиса. Пока backend-процесс временно недоступен:
- Веб-консоль (панель управления, страницы пополнения и т. д.) не загружается или показывает ошибки
- API (
api.apiyi.comи все остальные эндпоинты) возвращает 502
Что следует сделать
Шаг 1: Подождите 30–60 секунд, затем повторно отправьте запрос
Шаг 2: Если веб-консоль не загружается, выполните принудительное обновление страницы
Шаг 3: Если 502 сохраняется более 5 минут, обратитесь в поддержку
14:30 (UTC+8)).Добавление автоматических повторных попыток к программным вызовам
Если ваша нагрузка чувствительна к доступности, добавьте автоматические повторные попытки для временных ошибок вроде 502 на стороне клиента — одна повторная попытка примерно через 30 секунд покрывает всё окно перезапуска.- Python
- Node.js
- cURL
Часто задаваемые вопросы
Тарифицируются ли запросы, сделанные во время 502?
Тарифицируются ли запросы, сделанные во время 502?
Чем 502 отличается от таймаута, 429 или 524?
Чем 502 отличается от таймаута, 429 или 524?
502: backend-сервис временно недоступен (идёт перезапуск контейнера). Подождите 30-60 секунд и повторите попытку; не тарифицируется.- Таймаут / разорванное соединение: таймаут вашего клиента слишком короткий — сервер может всё ещё выполнять запрос и тарифицировать его обычным образом. См. Как избежать таймаутов API.
429: достигнут лимит параллельных запросов или лимит запросов; это не связано с доступностью сервиса. См. Лимиты параллельных запросов API.524: вы используете эндпоинт CDN (api-cf.apiyi.com) с запросом, превышающим примерно 100 секунд — переключитесь на другой эндпоинт.
Почему веб-консоль и API отказывают одновременно?
Почему веб-консоль и API отказывают одновременно?
Будет ли это происходить часто?
Будет ли это происходить часто?
Как понять, проблема это на стороне платформы или в моей сети?
Как понять, проблема это на стороне платформы или в моей сети?
- Откройте веб-консоль: если
api.apiyi.comвозвращает 502, а консоль тоже не загружается, скорее всего, это временный перезапуск на стороне платформы — подождите минуту. - Смените сеть: попробуйте мобильный интернет (другой оператор), чтобы загрузить консоль, или выполните команду ниже. Если там всё работает, проблема в вашей локальной сети или прокси.
Связанная документация
Как избежать тайм-аутов API
Нужен ли мне прокси для использования API?
Где находятся серверы APIYI?
Доступность сервиса и SLA
Свяжитесь с нами
Поддержка WeCom
