WazzaBee API арналары: қосылған желілер тізімін алу

GET /v1/channels

Ағымдағы интеграцияға қолжетімді қосылған байланыс желілерінің (арналардың) тізімін алу.

URL

GET https://api.wazzabee.com/api-gateway/v1/channels

Тақырыптар

Authorization: Bearer ВАШ_API_КЛЮЧ

Сұраныс параметрлері

Жоқ. Эндпоинт параметр қабылдамайды және ағымдағы API кілтіне қолжетімді барлық арнаны қайтарады.

Сұраныс мысалы

curl -X GET "https://api.wazzabee.com/api-gateway/v1/channels" \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ"

Сәтті жауап (200 OK)

{
  "success": true,
  "channels": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "WhatsApp Основной",
      "type": "whatsapp_qr",
      "status": "active"
    },
    {
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "name": "WhatsApp WABA",
      "type": "whatsapp_waba",
      "status": "active"
    },
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "name": "Telegram Бот",
      "type": "telegram_bot",
      "status": "active"
    }
  ]
}

Жауап өрістерінің сипаттамасы

Өріс	Түрі	Сипаттама
`channels`	array	Қолжетімді арналар массиві
`channels[].id`	string (UUID)	Арнаның бірегей ID-і. Оны басқа сұраныстарда қолданыңыз (`channelId`)
`channels[].name`	string	Пайдаланушы берген арна атауы
`channels[].type`	string	Арна түрі (төмендегі кестені қараңыз)
`channels[].status`	string	Мәртебе: `active`, `inactive`, `error`

Арна түрлері

Түрі (`type`)	Сипаттама
`whatsapp_qr`	QR-код арқылы WhatsApp (жеке нөмір)
`whatsapp_waba`	WhatsApp Business API (ресми)
`telegram_bot`	Бот арқылы Telegram
`telegram_personal`	Жеке аккаунт арқылы Telegram

Арналарды интеграция бойынша сүзу

Интеграция баптауларында нақты API кілті арқылы қандай арналар қолжетімді екенін көрсетуге болады:

Арналар көрсетілмеген: API кілті аккаунттың барлық арнасын көреді
Арналар көрсетілген: API кілті тек аталған арналарды көреді

Бұл қолжетімділік құқықтары әртүрлі бірнеше интеграцияңыз болса ыңғайлы.

💡 Кеңес: Қалған сұраныстарда қолдану үшін арналардың id мәнін алу мақсатында алдымен осы эндпоинтті шақырыңыз.

Ықтимал қателер

Бұл эндпоинт тек авторизация қателерін (401, 403) қайтара алады. Арналар болмаса, қате емес, бос массив қайтарылады.