Pro vývojáře

API klíče

Vytvořte klíč pro svůj vlastní software a posílejte ho s každým požadavkem na HANC API.

API klíč umožní vašemu vlastnímu softwaru používat HANC API: vypisovat hovory, vytvářet agenty, kupovat čísla, číst vaše CRM. Klíč jedná s vašimi oprávněními — co můžete dělat v dashboardu, to může dělat i přes API.

Vytvoření klíče

1. Otevřete klíče

   Integrace → karta Pro vývojáře → API klíče pracovního prostoru.

2. Vytvořte klíč

   Klikněte na Vytvořit API token. Klíč se objeví v seznamu; tlačítko pro zobrazení ho odkryje a odtud ho zkopírujete.

• Nejvýše 3 klíče na pracovní prostor.
• Klíče nemají název ani samostatná oprávnění: klíč má váš přístup ve všech pracovních prostorech, jejichž jste členem.
• Klíč lze ze seznamu kdykoli znovu zobrazit — se seznamem proto zacházejte jako s citlivým údajem.

Použití klíče

Posílejte klíč v hlavičce x-api-key, bez předpony Bearer:

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

Všechny endpointy popisuje Reference API.

Bezpečnost klíčů

• Klíče mějte na svém serveru — nikdy v prohlížeči, v mobilní aplikaci ani v ničem, co může uživatel otevřít.
• Nikdy je neukládejte do systému pro správu verzí.
• Čas od času je vyměňte za nové; klíč okamžitě smažte, když někdo odejde nebo když mohl uniknout.

Související

• Reference API
• Webhooky a doručování — data o hovoru, která se po každém hovoru odešlou do vašeho systému