Zum Hauptinhalt springen
Entwickler

API-Schlüssel

Erstellen Sie einen Schlüssel für Ihre eigene Software und senden Sie ihn mit jeder Anfrage an die HANC API.

Mit einem API-Schlüssel kann Ihre eigene Software die HANC API nutzen: Anrufe auflisten, Agenten erstellen, Nummern kaufen, Ihr CRM lesen. Ein Schlüssel handelt mit Ihren Zugriffsrechten — was Sie im Dashboard tun können, kann er über die API tun.

Einen Schlüssel erstellen​

  1. Schlüssel öffnen

    Integrationen → Tab Entwickler → Workspace-API-Schlüssel.

  2. Einen Schlüssel anlegen

    Klicken Sie auf API-Token erstellen. Der Schlüssel erscheint in der Liste; die Anzeige-Schaltfläche macht ihn sichtbar, von dort kopieren Sie ihn.

  • Bis zu 3 Schlüssel pro Arbeitsbereich.
  • Schlüssel haben keinen Namen und keine eigenen Berechtigungen: Ein Schlüssel hat Ihren Zugriff in jedem Arbeitsbereich, dem Sie angehören.
  • Ein Schlüssel lässt sich in der Liste erneut anzeigen — behandeln Sie die Liste als vertraulich.

Verwenden​

Senden Sie den Schlüssel im Header x-api-key, ohne das Präfix Bearer:

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

Jeder Endpunkt ist in der API-Referenz beschrieben.

Sicher aufbewahren​

  • Bewahren Sie Schlüssel auf Ihrem Server auf — niemals in einem Browser, einer mobilen App oder irgendetwas, das ein Nutzer öffnen kann.
  • Committen Sie sie nie in die Versionsverwaltung.
  • Tauschen Sie sie von Zeit zu Zeit aus; löschen Sie einen Schlüssel sofort, wenn jemand ausscheidet oder er durchgesickert sein könnte.
Auf dieser Seite