Saltar al contenido principal

Formato

Todo error responde JSON con un detail legible:
Cuando el cliente necesita reaccionar a un caso concreto, el cuerpo trae además error: un código estable que no cambia aunque cambie el texto. Programá contra error, no contra detail.
Los errores de validación de parámetros (422) usan el formato estándar: detail es una lista con el campo y el problema de cada uno.

Status

Ningún error consume créditos.

Códigos estables más comunes

Hay otros, propios de cada familia de endpoints y documentados en la referencia. Por ejemplo, ai_disabled (403) cuando tu organización apagó la IA o la búsqueda web, y los de las auditorías: bad_id, audit_id_mismatch, not_found, unknown_section y audit_source_unavailable.

Falla de la fuente o resultado vacío

Cada lectura a una fuente de datos termina en una de tres cosas: datos, un vacío que la fuente afirmó o una falla. Una falla nunca se presenta como «no hay datos».
Si no se pudo leer la dirección o la transacción que pediste, la respuesta es 503 con el motivo estructurado y sin cobro:
Si viene retry_after, la respuesta trae también el header Retry-After.
Ninguna falla se guarda en la cache: la próxima consulta vuelve a preguntarle a la fuente.

Motivos (reason)

source_fault dice si fue una falla de la fuente (true) o un tope o una consulta que no se hizo (false), y failure_cause explica por qué, en una frase.
Para saber si una fuente está caída y hasta cuándo, consultá GET /v1/sources (sin costo).