Authenticatie
Elk verzoek aan de API bevat een API-sleutel. Verzoeken worden nooit gekoppeld aan een browsersessie.
Een API-sleutel aanmaken
Maak sleutels aan onder API-sleutels in je account, maximaal 5. Zolang je bent ingelogd, kun je een sleutel op die pagina altijd kopiëren: we bewaren hem versleuteld en laten hem alleen aan jou zien. Houd hem geheim, net als een wachtwoord, en als hij mogelijk gezien is, trek hem dan in en maak een nieuwe aan.
Een API-sleutel meesturen
Stuur hem mee in de header Authorization als Bearer gevolgd door de sleutel. X-API-Key werkt ook.
curl "https://api.talismanleads.io/v1/account" \
-H "Authorization: Bearer tl_live_your_key_here"Wat een API-sleutel kan
Een nieuwe sleutel kan alles: je saldo, de checkers, je bestellingen en hun resultaten zien, en POST /uploads, POST /estimates en POST /orders gebruiken, die je lijst opslaan of je saldo uitgeven. Een sleutel die vóór 8 november 2026 is aangemaakt, kan alleen-lezen zijn: hij kan alles zien, maar die drie aanroepen weigeren hem met missing_scope.
Vervaldatum en IP-adressen
Een nieuwe sleutel verloopt nooit en werkt vanaf elk adres. Een sleutel die vóór 8 november 2026 is aangemaakt, kan een vervaldatum hebben, waarna hij wordt geweigerd met expired_key, of beperkt zijn tot de IP-adressen van je server, zodat een verzoek vanaf een andere plek wordt geweigerd met ip_not_allowed. Wil je een van beide wijzigen, maak dan een nieuwe sleutel aan en trek de oude in.
Een API-sleutel veilig houden
- Behandel een sleutel als een wachtwoord: iedereen die hem heeft, kan je saldo uitgeven.
- Gebruik hem alleen op je server. De API staat geen aanroepen vanaf een webpagina toe.
- Houd hem uit je code en je versiebeheer.
- Als een sleutel mogelijk gezien is, trek hem dan meteen in via je account. Hij werkt direct niet meer. Bestellingen die al geplaatst zijn, blijven lopen.
- Stuur hem alleen naar de API. Upload- en downloadlinks hebben hun eigen toestemming, dus stuur je sleutel er niet naartoe.
Als een API-sleutel wordt geweigerd
Bij een sleutel die onjuist, ingetrokken of verlopen is, is het antwoord 401. Bij een geblokkeerde sleutel of een geblokkeerd account is het antwoord 403. Zie Fouten.