Errores

Códigos de estado HTTP y formato del cuerpo de error devueltos por la API de javinfo.

Los errores usan códigos de estado HTTP estándar. Las solicitudes fallidas no se facturan — solo pagas por las respuestas 200 exitosas.

Códigos de estado

Estado	Significado
`400`	Solicitud incorrecta — ID de proveedor desconocido, o clave faltante en una sesión que debería estar autenticada.
`401`	Clave API faltante o inválida.
`402`	Saldo insuficiente — recarga tu cuenta. Consulta facturación.
`404`	No se encontraron resultados (todos los proveedores fallaron, o índice vacío para `/random`).
`429`	Límite de tasa o cuota diaria excedida. Reintenta después del encabezado `Retry-After`.
`499`	El cliente cerró la solicitud antes de que un proveedor respondiera.

Los errores devuelven un cuerpo JSON con un code legible por máquina y un message legible por humanos:

{
  "code": "NOT_FOUND",
  "message": "No result found for \"SSIS-999\"."
}

Cuando alcances el límite de tasa, espera usando el encabezado de respuesta Retry-After (segundos):

if (res.status === 429) {
  const wait = Number(res.headers.get('Retry-After') ?? 1);
  await new Promise((r) => setTimeout(r, wait * 1000));
}