Sobre
Las respuestas exitosas devuelven{ "data": … }. Las fallas devuelven un
objeto error y un estado HTTP distinto de 2xx. Ramifica según el código de
estado, no según un indicador en el cuerpo:
Tipos y códigos
No todos los endpoints emiten todos los códigos; la página de referencia de
cada endpoint lista los suyos. Un “sin coincidencias” nunca es un
404; es un
200 exitoso. Registraduría, SUNAT y RREE devuelven found: false, y SICAAC y
Superfinanciera devuelven una lista vacía. Un 404 significa que el endpoint o
el id del trabajo en sí no existe.Las consultas asíncronas pueden fallar como trabajo en
lugar de como un error HTTP. Un trabajo fallido lleva el mismo objeto
error
en el sobre, con code: "job_failed".