Autenticación
Cada solicitud a la API lleva una clave de API. Las solicitudes nunca se asocian a una sesión de navegador.
Crear una clave de API
Crea claves en Claves de API, en tu cuenta, hasta un máximo de 5. Puedes copiar una clave desde esa página en cualquier momento mientras tengas la sesión iniciada: la guardamos cifrada y solo te la mostramos a ti. Mantenla en secreto, como una contraseña, y si puede haberse visto, revócala y crea otra.
Enviar la clave de API
Envíala en el encabezado Authorization como Bearer seguido de la clave. X-API-Key también funciona.
curl "https://api.talismanleads.io/v1/account" \
-H "Authorization: Bearer tl_live_your_key_here"Qué puede hacer una clave de API
Una clave nueva puede hacerlo todo: ver tu saldo, los verificadores, tus pedidos y sus resultados, y usar POST /uploads, POST /estimates y POST /orders, que guardan tu lista o gastan tu saldo. Una clave creada antes del 8 de noviembre de 2026 puede ser de solo lectura: puede verlo todo, pero esas tres llamadas la rechazan con missing_scope.
Caducidad y direcciones IP
Una clave nueva nunca caduca y funciona desde cualquier dirección. Una clave creada antes del 8 de noviembre de 2026 puede tener una fecha de caducidad, después de la cual se rechaza con expired_key, o estar limitada a las direcciones IP de tu servidor, de modo que una solicitud desde cualquier otro lugar se rechaza con ip_not_allowed. Para cambiar cualquiera de las dos cosas, crea una clave nueva y revoca la antigua.
Mantener segura una clave de API
- Trata una clave como una contraseña: cualquiera que la tenga puede gastar tu saldo.
- Úsala solo en tu servidor. La API no permite llamadas desde una página web.
- Mantenla fuera de tu código y de tu control de versiones.
- Si una clave puede haberse visto, revócala en tu cuenta de inmediato. Deja de funcionar al instante. Los pedidos ya realizados siguen ejecutándose.
- Envíala solo a la API. Los enlaces de subida y de descarga llevan su propio permiso, así que no les envíes tu clave.
Cuando se rechaza una clave de API
Con una clave incorrecta, revocada o caducada, la respuesta es 401. Con una clave o una cuenta bloqueada, la respuesta es 403. Consulta Errores.