Перейти до основного вмісту
Розробникам

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.

Безпека​

  • Зберігайте ключі на своєму сервері — ніколи в браузері, у мобільному застосунку чи в будь-чому, що може відкрити користувач.
  • Ніколи не додавайте їх до системи контролю версій.
  • Час від часу змінюйте їх; одразу видаляйте ключ, якщо хтось пішов із команди або ключ міг витекти.
На цій сторінці