Je API-sleutels

Een sleutel maken

1. Open je avatar › API-sleutels en kies Nieuwe API-sleutel.
2. Noem hem naar wat hem gebruikt, bijvoorbeeld je rapportagetool.
3. Kies Alleen lezen of Lezen en wijzigen.
4. Kopieer hem nu: de sleutel wordt maar één keer getoond.

Wat een sleutel mag

Een sleutel mag wat jij in deze werkruimte mag en niets meer: de sleutel van een Owner ziet alles, die van een partner manager zijn eigen partners, die van een partner alleen diens eigen cijfers. Hij doet nooit wat alleen een ingelogde persoon mag, zoals sleutels, wachtwoorden of het team beheren.

Elke wijziging met een sleutel draagt zijn naam in het activiteitenlog, bijvoorbeeld „API-sleutel «BI» (gemaakt door Maria)”, zodat je altijd weet wat via de API kwam.

Hem gebruiken

Stuur hem bij elke aanroep naar het adres van je werkruimte, in x-api-key of als Authorization: Bearer. De aanroepen staan in De API-referentie.

Goed om te weten

• Het HitCTRL-abonnement van je werkruimte bepaalt of sleutels werken en hoeveel aanroepen per minuut ze mogen doen. Boven de limiet is het antwoord 429 met Retry-After.
• Trek een sleutel die je niet meer gebruikt in: hij stopt meteen en blijft in de lijst, zodat zijn wijzigingen zijn naam houden.
• Trackingaanroepen van je server gebruiken de eigen sleutels van de werkruimte: zie API-sleutels.