WP API

Коды ошибок — API данных WhatsApp

Все ответы об ошибках имеют одинаковую структуру: HTTP-статус + сообщение об ошибке + числовой код + метка времени.

Формы конвертов (наблюдаемые)

В зависимости от характера сбоя прокси-объект возвращает одну из двух форм:

Кратковременная ошибка (авторизация / ограничение на количество попыток / проверка):

{ "error": "Requests must be at least 0.5 seconds apart" }

Подробная ошибка (промах при поиске в /number/no_picture/{n}, /number-simple/{n}) — тело запроса по-прежнему интерпретируется как WhatsAppEntry с дополнительными полями:

{
  "number": "13105551234",
  "isWAContact": true,
  "error":  "Whatsapp number doesn't exist",
  "exists": false,
  "reason": "not_found",
  "status": 404,
  ...
}

Всегда проверяйте поле ошибки, даже если ответ содержит код 200 (например, /number_cache может вернуть код 200 с сообщением об ошибке внутри).

Типичные HTTP-статусы

HTTPЗначениеДействие
400Неверный номер телефона — должен совпадать с ^[0-9]+$ (только цифры, без +).Удалите нецифровые элементы перед отправкой. Проверьте локальную версию с помощью библиотеки libphonenumber.
401Отсутствует или недействителен заголовок x-rapidapi-key.Добавьте заголовки x-rapidapi-key и x-rapidapi-host: wp-data.p.rapidapi.com.
403Требуется активный тарифный план, квота исчерпана или конечная точка не входит в ваш тарифный план.Проверьте свою подписку на RapidAPI. Обновите тарифный план или пополните счет.
404Конечная точка или ресурс не найдены.Проверьте путь URL. Для /number/{number} неизвестный номер по-прежнему возвращает запись WhatsAppEntry с isWAContact: false — проверяйте текст сообщения, а не статус.
429Ограничение на количество запросов — слишком близко друг к другу. Тело запроса: {"error":"Requests must be at least 0.5 seconds apart"}.Перерыв между запросами должен составлять не менее 500 мс (2 запроса в секунду). Для MEGA: 250 мс (4 запроса в секунду). Для подтверждения темпа выполнения вашего плана ознакомьтесь с параметром /api-key-stats → roleInfo.minIntervalSeconds.
500Неожиданный сбой на стороне сервера.Повторите попытку с экспоненциальной задержкой. Сообщите, если проблема сохраняется.
502 / 503Каталог WhatsApp, предоставляемый исходящим из источника, недоступен или скорость передачи данных ограничена.Повторите попытку с задержкой. Проверьте /api-status.
504Истекло время ожидания при поиске в вышестоящем источнике.Повторите попытку. Для более быстрого ответа попробуйте /number/no_picture/{number}.

Стратегия повторной попытки

  • Повторная попытка: 429 (с кнопкой «Повторить после»), 500, 502, 503, 504.
  • Повторная попытка не требуется: 400, 401, 403, 404.
  • Откат: экспоненциальный с учетом дрожания. Максимальное количество повторных попыток — 5. Всегда учитывайте возможность повторной попытки.

Пример 429 тела

HTTP/1.1 429 Too Many Requests
content-type: application/json

{ "error": "Requests must be at least 0.5 seconds apart" }

Связанный

Ограничения скорости
Пример повторной попытки в Python
Пример повторной попытки в Node.js
Текущий статус API
Интерактивный справочник API (скалярные значения)

Что говорят наши пользователи

Настоящие отзывы от наших довольных клиентов

Загрузка отзывов...