Fejlesztőknek

API-kulcsok

Hozz létre kulcsot a saját szoftveredhez, és küldd el minden kéréssel a HANC API-nak.

Az API-kulccsal a saját szoftvered használhatja a HANC API-t: hívásokat listázhat, ügynököket hozhat létre, számokat vásárolhat, olvashatja a CRM-edet. A kulcs a te jogosultságaiddal működik — amit te megtehetsz az irányítópulton, azt ő is megteheti az API-n keresztül.

Kulcs létrehozása

1. Nyisd meg a kulcsokat

   Integrációk → Fejlesztőknek lap → Munkaterület API-kulcsai.

2. Hozz létre egyet

   Kattints az API token létrehozása gombra. A kulcs megjelenik a listában; a megjelenítés gombbal láthatóvá teszed, és onnan kimásolhatod.

• Munkaterületenként legfeljebb 3 kulcs.
• A kulcsoknak nincs nevük és külön jogosultságuk: egy kulcs a te hozzáférésével rendelkezik minden munkaterületen, amelynek tagja vagy.
• A kulcs a listából újra megjeleníthető — kezeld a listát bizalmas adatként.

Használat

A kulcsot az x-api-key fejlécben küldd, Bearer előtag nélkül:

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

Minden végpont leírása az API-referenciában található.

Biztonságos tárolás

• A kulcsokat a saját szervereden tárold — soha ne böngészőben, mobilalkalmazásban vagy bármiben, amit egy felhasználó megnyithat.
• Soha ne kerüljenek verziókezelőbe.
• Időnként cseréld le őket; egy kulcsot azonnal törölj, ha valaki távozik, vagy ha kiszivároghatott.

Kapcsolódó

• API-referencia
• Webhookok és kézbesítés — a hívásadatok, amelyeket minden hívás után a rendszeredbe küldünk