API жалпы қателері

API қателері мен лимиттері

WazzaBee API-дің барлық жауаптары JSON форматында қайтарылады. Қате болған кезде error өрісінде мәселенің сипаттамасы орыс тілінде беріледі.

Қате кезіндегі жауап форматы

{
  "error": "Описание ошибки",
  "details": "Дополнительная информация (опционально)"
}

Сәтті жауап форматы

{
  "success": true,
  ...данные ответа
}

HTTP жауап кодтары

Код	Мәртебе	Сипаттама	Не істеу керек
200	OK	Сұраныс сәтті орындалды	Жауаптағы деректерді өңдеңіз
202	Accepted	Сұраныс өңдеуге қабылданды (хабарлама жіберу үшін)	Хабарлама кезекте, жақын секундтарда жеткізіледі
400	Bad Request	Сұраныс параметрлері қате	Міндетті параметрлерді және олардың форматын тексеріңіз
401	Unauthorized	Авторизация қатесі	Authorization тақырыбын және API кілтін тексеріңіз
403	Forbidden	Ресурсқа рұқсат жоқ	Арналардың интеграцияға байланысын тексеріңіз
404	Not Found	Ресурс табылмады	Эндпоинт URL мекенжайын және ресурстардың ID-ін тексеріңіз
500	Internal Server Error	Сервердің ішкі қатесі	Сұранысты кейінірек қайталаңыз. Қате қайталана берсе, қолдау қызметіне жүгініңіз

Жиі кездесетін қателер және шешімдер

«Отсутствует заголовок Authorization» — Authorization тақырыбы жоқ (401)

Себебі: Сіз Authorization тақырыбын жібермегенсіз немесе оны қате форматта жібергенсіз.

Шешімі: Authorization: Bearer ВАШ_API_КЛЮЧ тақырыбын қосыңыз. Bearer сөзінен кейінгі бос орынға назар аударыңыз.

# ❌ Неправильно (нет заголовка)
curl -X GET "https://api.wazzabee.com/api-gateway/v1/channels"

# ❌ Неправильно (нет Bearer)
curl -X GET "https://api.wazzabee.com/api-gateway/v1/channels" \
  -H "Authorization: wac_live_sk_..."

# ✅ Правильно
curl -X GET "https://api.wazzabee.com/api-gateway/v1/channels" \
  -H "Authorization: Bearer wac_live_sk_..."

«Неверный API-ключ» — API кілті қате (401)

Себебі: Кілт жүйеден табылмады: мүмкін, қате терілген немесе басқа интеграцияның кілті.

Шешімі: Кілтті Коннекторлар → API бөлімінен қайта көшіріңіз.

«Интеграция деактивирована» — интеграция өшірілген (403)

Себебі: Интеграция жеке кабинетте өшірілген.

Шешімі: Коннекторлар бөліміне кіріп, интеграцияны іске қосыңыз.

«Канал не привязан к данной интеграции» — арна осы интеграцияға байланыстырылмаған (403)

Себебі: Сіз осы API кілті үшін рұқсат етілгендер тізіміне кірмейтін арнаны пайдаланғыңыз келеді.

Шешімі: Интеграция баптауларын тексеріп, қажетті арнаның қосылғанына көз жеткізіңіз.

«Канал не найден или нет доступа» — арна табылмады немесе рұқсат жоқ (404)

Себебі: Көрсетілген channelId жоқ немесе басқа аккаунтқа тиесілі.

Шешімі: Арналардың өзекті тізімін GET /v1/channels арқылы алыңыз.

«Канал неактивен» — арна белсенді емес (400)

Себебі: Арна (байланыс желісі) өшірілген немесе байланысын жоғалтқан.

Шешімі: Арна мәртебесін жеке кабинетте тексеріңіз. WhatsApp QR үшін: QR кодты қайта сканерлеу қажет болуы мүмкін.

«Неподдерживаемый тип канала» — арна түріне қолдау көрсетілмейді (400)

Себебі: Бұл арна түрі API арқылы жіберуге қолдау көрсетпейді.

Шешімі: Арнаның түрі қолдау көрсетілетін түрлердің бірі екеніне көз жеткізіңіз: whatsapp_qr, whatsapp_waba, telegram_bot, telegram_personal.

«Неизвестный маршрут» — белгісіз маршрут (404)

Себебі: Сіз жоқ эндпоинтке жүгіндіңіз.

Шешімі: URL мекенжайы мен HTTP әдісін тексеріңіз. Қолжетімді маршруттар:

POST   /v1/messages/send
GET    /v1/messages
GET    /v1/channels
PATCH  /v1/webhooks
GET    /v1/webhooks
POST   /v1/iframe

Лимиттер

Параметр	Лимит	Сипаттама
Тарихқа бір сұраныстағы хабарламалар	200	GET /v1/messages ішіндегі limit ең үлкен мәні
iframe сессиясының қызмет ету уақыты	24 сағат	Мерзімі өткен соң жаңа сессия құру керек
Webhook тестілік сұранысының таймауты	10 секунд	Вебхукты тіркеу кезінде Сіздің серверіңіз 10 секунд ішінде жауап беруі тиіс

Ұсынымдар

• Деректерді өңдемес бұрын жауаптағы success өрісін әрдайым тексеріңіз
• Қате кодтарын бағдарлама арқылы өңдеңіз, тек қате мәтініне сүйенбеңіз
• 500 қатесі кезінде 5-10 секунд күтіп, сұранысты қайталаңыз
• channelId мәнін конфигурацияда сақтаңыз және әр жіберу алдында арналарды сұрамаңыз
• GET /v1/messages-ті үздіксіз сұраудың орнына webhooks пайдаланыңыз