Formato de error
Todas las respuestas de error de la API siguen esta estructura:Nombre del tipo de error. Corresponde al nombre de la clase de excepcion interna (ej.
InvalidRequest, InvalidEncoding, InternalServerError).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.