Әзірлеушілерге

API кілттері

Өз бағдарламаңызға кілт жасап, оны HANC API-ге жіберілетін әр сұраумен бірге жіберіңіз.

API кілті өз бағдарламаңызға HANC API-ді пайдалануға мүмкіндік береді: қоңыраулар тізімін алу, агенттер жасау, нөмірлер сатып алу, CRM-іңізді оқу. Кілт сіздің құқықтарыңызбен әрекет етеді — кабинетте сіз не істей алсаңыз, ол да API арқылы соны істей алады.

Кілт жасау

1. Кілттерді ашыңыз

   Интеграциялар → Әзірлеушілерге қойындысы → Жұмыс кеңістігінің API кілттері.

2. Кілт жасаңыз

   API токенін жасау батырмасын басыңыз. Кілт тізімде пайда болады; көрсету батырмасы оны ашады, сол жерден көшіріп алыңыз.

• Бір жұмыс кеңістігіне 3 кілтке дейін.
• Кілттердің аты да, жеке рұқсаттары да жоқ: кілт сіз мүше болып тұрған әр жұмыс кеңістігінде сіздің қолжетімділігіңізге ие.
• Кілтті тізімнен қайта көрсетуге болады — сондықтан тізімді құпия дерек ретінде ұстаңыз.

Пайдалану

Кілтті x-api-key тақырыбында, Bearer префиксінсіз жіберіңіз:

curl "https://api.hanc.ai/v1/agent/list" \
  -H "x-api-key: YOUR_API_KEY"

Барлық эндпоинттер API анықтамасында сипатталған.

Қауіпсіз сақтау

• Кілттерді өз серверіңізде сақтаңыз — ешқашан браузерде, мобильді қосымшада немесе пайдаланушы аша алатын кез келген жерде емес.
• Оларды ешқашан нұсқаларды басқару жүйесіне жүктемеңіз.
• Оларды мезгіл-мезгіл ауыстырып тұрыңыз; біреу кетсе немесе кілт жария болып қалуы мүмкін болса, оны бірден жойыңыз.

Қатысты беттер

• API анықтамасы
• Вебхуктар және жеткізу — әр қоңыраудан кейін жүйеңізге жіберілетін қоңырау деректері