Haz tu primera llamada
Autentica una petición a la API de Veille y lee la respuesta.
Una vez que tienes una clave, la autenticación se reduce a una cabecera. Esta página muestra la forma de una petición, cómo confirmar que ha funcionado y qué hacer cuando no es así.
Respuesta
{
"remaining": 42180,
"total_used": 57820,
"renewal_date": "2026-04-01"
}Registros API
Enviar la petición
Pasa tu clave en la cabecera x-api-key en cada llamada. El endpoint de consumo es gratuito, lo que lo convierte en la forma más segura de validar una clave nueva:
curl "https://api.veille.io/v1/usage" \
-H "x-api-key: $API_KEY"const res = await fetch("https://api.veille.io/v1/usage", {
headers: { "x-api-key": process.env.API_KEY },
})
if (!res.ok) throw new Error(`Request failed: ${res.status}`)
const usage = await res.json()Cómo es una respuesta de consumo correcta
Un 200 del endpoint de consumo significa que la clave funciona. El JSON incluye remaining (autonomía combinada), los saldos subscription y credits, renewal_date cuando aplica un periodo, y la api_key que hizo la llamada — incluidas sus cuotas. Ninguna de esas llamadas consume créditos.
Si no funciona
| Respuesta | Causa | Solución |
|---|---|---|
401 Invalid API Key | Falta la cabecera o el valor es incorrecto | Comprueba que no se haya copiado un espacio o un salto de línea con el secreto |
401 Inactive API Key | La clave está desactivada | Reactívala en Claves API, o crea una nueva |
401 Rate limit exceeded | Se ha alcanzado una cuota por clave o el límite de tasa de tu plan | Reduce el ritmo o sube los límites de la clave |
402 Payment required | No quedan créditos o hay una factura impagada | Añade una recarga, activa la recarga automática o paga la factura |
Configura el tiempo de espera de tu cliente HTTP en 60 segundos como mínimo. Muchas plataformas usan valores por defecto mucho más bajos y cortan la llamada antes de que Veille responda.