Le tue chiavi API

Creare una chiave

1. Apri il tuo avatar › Chiavi API e scegli Nuova chiave API.
2. Dalle il nome di ciò che la userà, per esempio il tuo strumento di report.
3. Scegli Solo lettura o Leggere e modificare.
4. Copiala ora: la chiave viene mostrata una sola volta.

Cosa può fare una chiave

Una chiave fa ciò che puoi fare tu in questo workspace e niente di più: la chiave di un Owner vede tutto, quella di un partner manager vede i propri partner, quella di un partner vede solo i propri numeri. Non fa mai ciò che può fare solo una persona che ha effettuato l'accesso, come gestire chiavi, password o il team.

Ogni modifica fatta con una chiave porta il suo nome nel registro attività, per esempio «Chiave API «BI» (creata da Maria)», così sai sempre cosa è arrivato tramite l'API.

Usarla

Inviala a ogni chiamata all'indirizzo del tuo workspace, in x-api-key o come Authorization: Bearer. Le chiamate sono elencate in Il riferimento API.

Buono a sapersi

• Il piano HitCTRL del tuo workspace decide se le chiavi funzionano e quante chiamate al minuto possono fare. Oltre il limite, la risposta è 429 con Retry-After.
• Revoca una chiave che non usi più: si ferma subito e resta in elenco, così le sue modifiche mantengono il nome.
• Le chiamate di tracciamento del tuo server usano le chiavi proprie del workspace: vedi Chiavi API.