Autenticación - Timbre by Taxo

Autenticación con Llave API

Todos los endpoints de la API de Timbre (excepto el health check) requieren autenticación usando un token Bearer.

Obtener tu Llave API

Inicia sesión en tu cuenta de Timbre en api.usatimbre.com
Navega a la configuración de tu perfil
Genera o copia tu llave API

Tu llave API comienza con tmb_ y debe mantenerse segura. Nunca la expongas en código del lado del cliente.

Usar tu Llave API

Incluye tu llave API en el header Authorization de cada solicitud:

Authorization: Bearer tmb_tu_llave_api_aqui

Ejemplo de Solicitud

curl -X GET "https://api.usatimbre.com/api/profile/XAXX010101000" \
  -H "Authorization: Bearer tmb_tu_llave_api_aqui"

const response = await fetch('https://api.usatimbre.com/api/profile/XAXX010101000', {
  headers: {
    'Authorization': 'Bearer tmb_tu_llave_api_aqui'
  }
});

import requests

response = requests.get(
    'https://api.usatimbre.com/api/profile/XAXX010101000',
    headers={'Authorization': 'Bearer tmb_tu_llave_api_aqui'}
)

Respuestas de Error

Si la autenticación falla, recibirás una respuesta 401 Unauthorized:

{
  "error": "Unauthorized",
  "message": "Llave API inválida o faltante"
}

Mantén tu llave API segura. Si crees que tu llave ha sido comprometida, regenera una nueva inmediatamente desde la configuración de tu perfil.

​Autenticación con Llave API

​Obtener tu Llave API

​Usar tu Llave API

​Ejemplo de Solicitud

​Respuestas de Error

Autenticación con Llave API

Obtener tu Llave API

Usar tu Llave API

Ejemplo de Solicitud

Respuestas de Error