Skip to main content

​
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

  1. Inicia sesión en tu cuenta de Timbre en api.usatimbre.com
  2. Navega a la configuración de tu perfil
  3. 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"

​
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.