Краткий ответ
- Корневая причина — автоматический перезапуск контейнера сервиса — в течение окна перезапуска веб-консоль недоступна, а 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: Бэкенд-сервис временно недоступен (контейнер перезапускается). Подождите 30–60 секунд и повторите попытку; не тарифицируется.- Тайм-аут / разрыв соединения: Тайм-аут вашего клиента слишком короткий — сервер всё ещё может выполнять запрос и тарифицировать его в обычном порядке. См. Как избежать тайм-аутов API.
429: Достигнут лимит параллельных запросов или лимит запросов; это не связано с доступностью сервиса. См. Лимиты параллельных запросов API.524: Вы используете CDN-эндпоинт (api-cf.apiyi.com) с запросом, превышающим примерно 100 секунд — переключите эндпоинт.
Почему веб-консоль и API перестают работать одновременно?
Почему веб-консоль и API перестают работать одновременно?
Будет ли это происходить часто?
Будет ли это происходить часто?
Как определить, связана ли проблема с платформой или с моей сетью?
Как определить, связана ли проблема с платформой или с моей сетью?
- Откройте веб-консоль: если
api.apiyi.comвозвращает 502 и консоль также не загружается, это почти наверняка временный перезапуск на стороне платформы — подождите минуту. - Смените сеть: попробуйте загрузить консоль через мобильный интернет (другого оператора) или выполните команду ниже. Если там всё работает, проблема в вашей локальной сети или прокси.
Связанная документация
Как избежать тайм-аутов API
Нужен ли мне прокси для использования API?
Где находятся серверы APIYI?
Доступность сервиса и SLA
Свяжитесь с нами
Поддержка WeCom
