Dla programistów

Klucze API

Utwórz klucz dla własnego oprogramowania i wysyłaj go z każdym żądaniem do HANC API.

Klucz API pozwala Twojemu własnemu oprogramowaniu korzystać z HANC API: wyświetlać listę połączeń, tworzyć agentów, kupować numery, czytać Twój CRM. Klucz działa z Twoimi uprawnieniami — co możesz zrobić w panelu, to on może zrobić przez API.

Utwórz klucz

1. Otwórz klucze

   Integracje → karta Dla programistów → Klucze API przestrzeni.

2. Utwórz klucz

   Kliknij Utwórz token API. Klucz pojawi się na liście; przycisk pokazywania go odsłoni, a stamtąd go skopiujesz.

• Do 3 kluczy na przestrzeń roboczą.
• Klucze nie mają nazwy ani osobnych uprawnień: klucz ma Twój dostęp w każdej przestrzeni roboczej, do której należysz.
• Klucz można ponownie wyświetlić z listy — traktuj listę jako poufną.

Jak go używać

Wysyłaj klucz w nagłówku x-api-key, bez prefiksu Bearer:

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

Każdy endpoint jest opisany w Dokumentacji API.

Dbaj o bezpieczeństwo

• Trzymaj klucze na swoim serwerze — nigdy w przeglądarce, aplikacji mobilnej ani w niczym, co może otworzyć użytkownik.
• Nigdy nie umieszczaj ich w systemie kontroli wersji.
• Co jakiś czas je wymieniaj; usuń klucz od razu, gdy ktoś odchodzi albo gdy klucz mógł wyciec.

Powiązane

• Dokumentacja API
• Webhooki i dostarczanie — dane połączenia wysyłane do Twojego systemu po każdej rozmowie