Errores

Todo error es un documento RFC 7807 con Content-Type: application/problem+json. Mismo formato para todos los endpoints.

{
  "type": "https://istmobot.com/errors/validation",
  "title": "Entrada inválida",
  "status": 422,
  "detail": "Campo `file` requerido (multipart/form-data)",
  "request_id": "req_3f9c2a"
}

type: identificador estable del error. Compara contra este, no contra title.
status: igual al código HTTP.
detail: explicación para humanos. Puede faltar.
request_id: inclúyelo al escribir a soporte.

Catálogo

HTTP	type	Cuándo	Qué hacer
401	`unauthorized` API key inválida o ausente	Header faltante, key mal formada o revocada.	Revisa el header Authorization y la key en el panel.
402	`insufficient-credits` Créditos insuficientes	El endpoint cuesta más de lo que queda en tu saldo.	Recarga o sube de plan. La llamada no se procesó.
403	`forbidden` Sin permiso	La key no puede usar ese recurso.	Usa otra key o escríbenos.
404	`not-found` No encontrado	La ruta no existe o la consulta no dio resultado.	Comprueba la URL y el valor consultado.
422	`validation` Entrada inválida	Falta el campo file, el archivo supera 10 MB o el valor de la URL no tiene el formato esperado.	Lee detail; dice qué campo falló.
422	`extraction-failed` No se pudo extraer el documento	La imagen no es legible o no corresponde al tipo de documento.	Envía una captura más nítida o al endpoint correcto. No cuesta créditos.
429	`rate-limited` Límite de peticiones excedido	Superaste las llamadas por minuto de tu plan.	Espera X-RateLimit-Reset y reintenta.
502	`upstream` Fuente externa no disponible	DGI o ATTT no respondió (endpoints de consulta).	Reintenta con backoff. No cuesta créditos.
500	`internal` Error interno	Fallo de nuestro lado.	Reintenta. Si persiste, mándanos el request_id.

type siempre va con el prefijo https://istmobot.com/errors/.

Reintentos

Reintenta 429, 502 y 500 con backoff exponencial (1 s, 2 s, 4 s). No reintentes 401, 402 ni 422: el resultado no cambia sin corregir la entrada. Ningún error consume créditos; ver Créditos y límites.