Un token API permette al tuo codice di comunicare con Ocoya. Li trovi in Settings → API: Settings si trova nel menu dell’account, l’avatar in alto nella barra laterale.
Questa pagina spiega come gestire i token. Per sapere come chiamare davvero l’API (URL di base, header, endpoint) consulta la documentazione dell’API REST.
Parti da qui. Il menu dell’account è l’avatar in alto nella barra laterale: Settings, poi API nella barra laterale delle impostazioni.
Settings → API, con il grafico delle richieste in alto e i tuoi token sotto.
Creare un token
Seleziona Create token e dagli un nome. Il nome serve solo a te: ti aiuta a distinguere i token in seguito e a revocare quello giusto.
Dai ai token il nome del posto in cui li usi, non di ciò che fanno. Zapier, server di staging, script di reportistica ti dice cosa smette di funzionare quando lo revochi. Chiave API 2 no.
Copia il token appena viene creato e conservalo in un posto sicuro. In seguito Ocoya mostra solo i primi e gli ultimi caratteri.
A cosa può accedere un token
Ogni token può accedere a tutti i brand di proprietà di questo account. Non è possibile limitare un token a un solo brand: nell’elenco dei token vedi All brands accanto a ciascuno.
Conta se pensavi di dare allo sviluppatore di un cliente un token solo per il suo brand. Non si può: potrebbe accedere a tutti i brand che possiedi.
Revocare un token
Il menu ⋯ di ogni token offre Delete token. L’eliminazione è immediata e permanente: tutto ciò che usa quel token smette subito di funzionare, quindi assicurati di sapere cosa lo sta usando. Per questo servono i nomi.
Non è possibile ruotare un token sul posto. Per sostituirne uno: crea il nuovo token, sposta la tua integrazione e poi elimina quello vecchio.
Controllare l’utilizzo
Il grafico API usage mostra le richieste autenticate del brand corrente nell’ultima ora, nell’ultimo giorno o negli ultimi 30 giorni. È il modo più rapido per verificare che un’integrazione stia davvero chiamando Ocoya, o per accorgerti di una che fa molte più chiamate del previsto.
Ocoya consente 60 richieste al minuto per chiave e restituisce 429 Too Many Requests oltre questo limite. Tutti i dettagli, compresi gli header dei limiti di frequenza, sono in Rate limits.