Autenticación

La API CallerID utiliza tokens JWT (JSON Web Tokens) para autenticación. Cada token tiene asociado un número de créditos que se consumen con cada búsqueda.

Obtención de Tokens

Los tokens se obtienen a través de la tienda

• Créditos iniciales: Número de búsquedas disponibles
• Créditos restantes: Búsquedas que aún puedes realizar
• Token JWT: Cadena de texto que identifica y autentica tu token

Uso del Token

El token se envía únicamente en el body de la petición, no en los headers:

{
  "api_key": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "query": "34600000001"
}

Consumo de Créditos

• Cada búsqueda exitosa consume 1 crédito
• Si un token no tiene créditos, la búsqueda será rechazada
• Los créditos restantes se devuelven en cada respuesta

Validación

El token se valida en cada petición. Si el token es inválido o no tiene créditos, recibirás un error:

{
  "detail": "Invalid token"
}

o

{
  "detail": "No credits remaining"
}

Seguridad

• No compartas tus tokens públicamente
• Los tokens son únicos e intransferibles
• Cada token tiene un límite de créditos para prevenir abuso