Sådan laver I en API-nøgle

Sådan gør du

1. Gå til Indstillinger → API og integrationer → API-nøgler.
2. Giv nøglen et navn, der siger, hvilket system den er til.
3. Vælg de scopes, den skal have. Ingen er valgt på forhånd.
4. Kopiér nøglen med det samme — den vises kun én gang.

Tre regler

• Én nøgle pr. system. Så kan én tilbagekaldes uden at slukke for resten.
• Kun de scopes, der skal bruges. Ikke alle, fordi det er nemmest.
• Tilbagekald, når nogen stopper, eller når et system udfases.

Grænsen for antal kald tælles pr. konto, ikke pr. nøgle: Basis 60, Plus 300 og Skala 1.200 kald i minuttet.

Scopes, det er værd at kende

Scope	Giver
contacts:read / contacts:write	Kartoteket og mærkater
contacts:export	ALT om én person, inkl. samtaler — kun til indsigtsanmodninger
calls:read	Opkald, resuméer og transskripter
calls:write	Markere opkald ordnet og sætte etiketter
recordings:read	Selve lyden
bookings:read / bookings:write	Aftaler og ledige tider
checkin:write	Kun at melde ankomst — til en skærm i venteværelset
tasks:read / tasks:write	Beskeder om at ringe tilbage
sms:read / sms:write	Læse og sende sms
blocks:read / blocks:write	Spærrede numre
webhooks:read / webhooks:write	Modtagere af hændelser

contacts:export følger IKKE med contacts:read. En nøgle, der kun skal slå et nummer op, skal ikke kunne hente hver samtale, en patient har haft.

Webhook-hemmeligheden

Hemmeligheden til en webhook vises også kun én gang. Er den tabt, laves en ny under API og integrationer eller med POST /v1/webhooks/{id}/rotate-secret. Den gamle holder op med at virke med det samme.

Den fulde dokumentation står på telefonai.dk/docs.