Skip to main content
La API de Camtom usa codigos HTTP estandar. Los errores devuelven un objeto JSON con el tipo de error, un mensaje descriptivo y el codigo de estado.

Formato de error

Todas las respuestas de error de la API siguen esta estructura:
string
Nombre del tipo de error. Corresponde al nombre de la clase de excepcion interna (ej. InvalidRequest, InvalidEncoding, InternalServerError).
string
Descripcion legible del error. Util para debugging y logs.
number
Codigo de estado HTTP del error.

Referencia de codigos

Errores del cliente (4xx)

Errores del servidor (5xx)

Errores de validacion (422) - Detalle

Los errores de validacion de CamtomDocs incluyen un campo errors adicional con detalles por campo:

Manejo de errores

Patron recomendado

Escenarios comunes y soluciones

API key invalida (401)

Solucion: Verifica que el header Authorization tenga el formato Bearer sk_... y que la key no haya sido revocada. Genera una nueva key desde app.camtomx.com si es necesario.

Suscripcion no valida (403)

Solucion: Verifica que tu organizacion tenga una suscripcion pro o enterprise activa. Las API keys requieren uno de estos planes.

Pais no permitido (403)

Solucion: Las organizaciones con plan free solo pueden usar country_code=WORLD. Actualiza a plan pro para acceder a clasificaciones por pais.

Creditos insuficientes (402)

Solucion: Recarga creditos desde Settings > Billing en app.camtomx.com.

Error de validacion (422)

Solucion: Revisa que el campo json_data contenga un JSON valido con document_type, document_description y un json_response no vacio que cumpla con JSON Schema Draft 7.

Error de procesamiento (502)

Solucion: Reintenta la peticion. Si el error persiste, verifica que el documento sea legible y que el schema no sea excesivamente complejo.

Error de codificacion (400)

Solucion: Asegurate de que el request use codificacion UTF-8.
Si recibes errores de forma consistente y no puedes resolverlos, contacta al equipo de soporte en app.camtomx.com con el tipo de error, el mensaje completo y un ejemplo del request que genera el error.
Last modified on March 8, 2026