Formato
Todo error responde JSON con undetail legible:
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».- Falló lo que pediste
- Falló un paso intermedio
Si no se pudo leer la dirección o la transacción que pediste, la respuesta es Si viene
503 con el motivo estructurado y
sin cobro:retry_after, la respuesta trae también el header Retry-After.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.