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 campoerrors adicional con detalles por campo:
Manejo de errores
Patron recomendado
Escenarios comunes y soluciones
API key invalida (401)
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)
pro o enterprise activa. Las API keys requieren uno de estos planes.
Pais no permitido (403)
free solo pueden usar country_code=WORLD. Actualiza a plan pro para acceder a clasificaciones por pais.
Creditos insuficientes (402)
Error de validacion (422)
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)
Error de codificacion (400)
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.