Autenticazione
Ogni richiesta all’API contiene una chiave API. Le richieste non vengono mai associate a una sessione del browser.
Creare una chiave API
Crea le chiavi in Chiavi API nel tuo account, fino a 5. Puoi copiare una chiave da quella pagina in qualsiasi momento mentre hai effettuato l’accesso: la conserviamo cifrata e la mostriamo solo a te. Tienila segreta, come una password, e se potrebbe essere stata vista, revocala e creane un’altra.
Inviare la chiave API
Inviala nell’intestazione Authorization come Bearer seguito dalla chiave. Funziona anche X-API-Key.
curl "https://api.talismanleads.io/v1/account" \
-H "Authorization: Bearer tl_live_your_key_here"Cosa può fare una chiave API
Una nuova chiave può fare tutto: vedere il tuo saldo, i verificatori, i tuoi ordini e i loro risultati, e usare POST /uploads, POST /estimates e POST /orders, che salvano la tua lista o spendono il tuo saldo. Una chiave creata prima dell’8 novembre 2026 può essere di sola lettura: può vedere tutto, ma quelle tre chiamate la rifiutano con missing_scope.
Scadenza e indirizzi IP
Una nuova chiave non scade mai e funziona da qualsiasi indirizzo. Una chiave creata prima dell’8 novembre 2026 può avere una data di scadenza, dopo la quale viene rifiutata con expired_key, oppure essere limitata agli indirizzi IP del tuo server, così che una richiesta da qualsiasi altro luogo venga rifiutata con ip_not_allowed. Per cambiare l’una o l’altra cosa, crea una nuova chiave e revoca quella vecchia.
Tenere al sicuro una chiave API
- Tratta una chiave come una password: chiunque la possieda può spendere il tuo saldo.
- Usala solo sul tuo server. L’API non consente chiamate da una pagina web.
- Tienila fuori dal tuo codice e dal tuo controllo di versione.
- Se una chiave potrebbe essere stata vista, revocala subito nel tuo account. Smette di funzionare immediatamente. Gli ordini già effettuati continuano a essere eseguiti.
- Inviala solo all’API. I link di caricamento e di download hanno una propria autorizzazione, quindi non inviare loro la tua chiave.
Quando una chiave API viene rifiutata
Con una chiave errata, revocata o scaduta, la risposta è 401. Con una chiave o un account bloccati, la risposta è 403. Vedi Errori.