Autenticazione e chiavi API
Come inviare la tua chiave API, quante chiavi puoi avere, cosa può e non può fare una chiave, cosa fare se ne trapela una e come scollegare un assistente IA.
Invia la chiave nell'intestazione Authorization
Authorization: Bearer YOUR_API_KEYQuell'intestazione è l'unico posto in cui l'API legge una chiave.
- Non mettere mai una chiave in un URL (
?api_key=…). Gli URL finiscono nei log, nella cronologia del browser e nei link condivisi. L'API rifiuta una richiesta così con400 api_key_in_query. Considera quella chiave esposta: revocala e creane una nuova. - Chiama esattamente
https://gloriads.com/api/v1: un client che segue un reindirizzamento verso un altro indirizzo perde la tua chiave per strada. - Chiama l'API da un foglio di calcolo, da uno script o da un server, non dal codice di una pagina web: chiunque visiti la pagina potrebbe leggere la chiave.
Cosa può fare una chiave
- Leggere il tuo account, su ogni endpoint.
- Non cambiare nulla. L'API è di sola lettura.
- Condividere i limiti del tuo account: tutte le tue chiavi e gli assistenti IA collegati contano insieme, quindi una seconda chiave non ti dà più richieste. Vedi Limiti ed errori.
Crea una chiave
Impostazioni → API → Crea una chiave.
- Solo il proprietario e gli amministratori dell'account vedono Impostazioni → API, creano e revocano chiavi e collegano assistenti IA.
- Il nome può essere lungo fino a 40 caratteri. Usa il nome dello strumento, così saprai quale chiave revocare in seguito.
- La chiave viene mostrata una sola volta. Ne conserviamo solo un'impronta, quindi nessuno può mostrarla di nuovo, nemmeno noi. Salvala in un gestore di password o nelle impostazioni segrete del tuo strumento.
- Puoi avere 10 chiavi alla volta.
- L'account demo pubblico non può creare chiavi.
L'elenco delle chiavi
Ogni chiave mostra il suo nome, i primi caratteri (key_live_ab12…), quando è
stata creata e quando è stata usata l'ultima volta.
«Ultimo utilizzo» viene aggiornato al massimo una volta all'ora, quindi una chiave usata qualche minuto fa può ancora mostrare un'ora precedente.
Revoca una chiave
Apri il menu ⋯ della chiave, poi Revoca.
Ha effetto subito: la richiesta successiva con quella chiave riceve
401 unauthorized, la stessa risposta di una chiave mai esistita. Una chiave
revocata non si può ripristinare: creane una nuova.
Assistenti IA collegati senza chiave
claude.ai e ChatGPT non usano nessuna chiave: accedi a Gloriads dall'assistente e fai clic su Consenti. L'assistente ottiene allora un accesso suo, che può solo leggere. Come collegarne uno: Collega un assistente IA.
- Impostazioni → API → App collegate elenca ogni assistente, l'indirizzo che ha chiesto l'accesso, quando l'hai collegato e quando ha letto il tuo account l'ultima volta (aggiornato al massimo una volta all'ora).
- Non verificata accanto a un nome significa che l'app si è registrata da sola senza dimostrare il proprio indirizzo. Tienila solo se l'hai collegata tu.
- Per fermarne una, apri il suo menu ⋯, poi Scollega. Ha effetto subito. Per usarla di nuovo, ricollegala dall'assistente.
Quando una richiesta viene rifiutata
| Risposta | Perché | Cosa fare |
|---|---|---|
401 unauthorized | Nessuna intestazione Authorization, oppure una chiave sbagliata o revocata | Controlla l'intestazione e la chiave |
403 subscription_inactive | Il tuo abbonamento è terminato | Abbonati in Impostazioni → Fatturazione |
400 api_key_in_query | La chiave era nell'URL | Spostala nell'intestazione, poi revocala |
Ogni altro codice è descritto in Limiti ed errori.
La chiave demo pubblica
Il riferimento dell'API precompila il suo pulsante Try it con una chiave pubblica. Legge solo l'account demo ed è limitata a 10 richieste al minuto, condivise da tutti i visitatori. Non può leggere il tuo account: per quello usa la tua chiave.