Авторизация

    4 мүн окуу
    ·
    530 көрүү
    ·
    Жаңыртылды: 10/22/2026

    API'де авторизация

    WazzaBee API'ге бардык суроо-талаптар Bearer-токен менен Authorization HTTP-аталышы аркылуу авторизацияланат. Токен — бул API коннекторун туташтырганда алган API-ачкычыңыз.

    Аталыштын форматы

    Authorization: Bearer ВАШ_API_КЛЮЧ

    Негизги URL

    https://api.wazzabee.com/api-gateway

    Бардык эндпоинттер ушул негизги URL менен башталат. Мисалы, билдирүү жөнөтүү үчүн толук URL:

    https://api.wazzabee.com/api-gateway/v1/messages/send

    API-ачкычты кайдан алса болот

    1. WazzaBee жеке кабинетине кириңиз
    2. Каптал менюдагы Коннекторлор бөлүмүнө өтүңүз
    3. «API» карточкасын таап, «Туташтыруу» баскычын басыңыз
    4. API-ачкыч автоматтык түрдө түзүлүп, экранда көрсөтүлөт
    5. Ачкычты көчүрүп, ишенимдүү жерде сактаңыз
    ⚠️ Коопсуздук:
    • API-ачкычты эч качан URL'де же суроо-талаптын параметрлеринде бербеңиз
    • Ачкычты ачык репозиторийлерге (GitHub, GitLab ж.б.) жарыяламаңыз
    • Ачкычты коддо эмес, чөйрө өзгөрмөлөрүндө сактаңыз
    • Эгер ачкыч бөтөн колго түшүп калса, интеграцияны өчүрүп, жаңысын түзүңүз

    Суроо-талаптын мисалы

    curl -X GET "https://api.wazzabee.com/api-gateway/v1/channels" \
      -H "Authorization: Bearer wac_live_sk_a1b2c3d4e5f6..."

    Авторизация катасындагы жооп

    Authorization аталышы жок (401)

    {
      "error": "Отсутствует заголовок Authorization. Формат: Bearer <api_key>"
    }

    Ачкычтын форматы туура эмес (401)

    {
      "error": "Неверный формат API-ключа"
    }

    Ачкыч системада табылган жок (401)

    {
      "error": "Неверный API-ключ"
    }

    Интеграция өчүрүлгөн (403)

    {
      "error": "Интеграция деактивирована"
    }

    Каналдарды интеграцияга байлоо

    Ар бир интеграцияны белгилүү байланыш линияларына (каналдарга) байлоого болот. Бул API-ачкычтын жетүүсүн керектүү каналдар менен гана чектөөгө мүмкүндүк берет.

    • Эгер жөндөөлөрдө каналдар көрсөтүлбөсө, API-ачкыч аккаунттун бардык каналдарына жете алат
    • Эгер каналдар көрсөтүлсө, жетүү тизмедеги каналдарга гана болот
    • Бөтөн каналга кайрылууга аракет кылганда 403 катасы кайтат

    Колдоого алынган HTTP-методдор

    МетодЭндпоинтСүрөттөмө
    GET/v1/channelsКаналдардын тизмеси
    POST/v1/messages/sendБилдирүү жөнөтүү
    GET/v1/messagesБилдирүүлөрдүн тарыхы
    PATCH/v1/webhooksВебхукту жөндөө
    GET/v1/webhooksВебхук жөндөөлөрүн алуу
    POST/v1/iframeiframe-сессия түзүү

    CORS

    API'ге суроо-талаптарды өз сервериңизден да, браузерден да жөнөтсө болот. Браузер адегенде алдын ала OPTIONS суроо-талабын жөнөтөт, ал эми API жоопто браузер санап берген методго жана аталыштарга уруксат берет. Методду баш тамгалар менен жазыңыз: patch эмес, PATCH.

    Барактын кодундагы API ачкычын ар бир келүүчү көрө алат, ошондуктан иштөөчү суроо-талаптарды өз сервериңизден жөнөткөнүңүз жакшы. Вебхукту кабинетте туташтыруу эң оңой: «Коннекторлор» → «API» → «Webhook для входящих» блогу.