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 аталышы жок» (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 ачкычы туура эмес» (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 колдонуңуз