Skip to content
CurriculoCurriculo ATS DocumentationDocs
API referenceConsole

Errores

On this page

Los errores son JSON y llevan el HTTP estado que importa. Nada falla silenciosamente: una solicitud rechazada te dice por qué. Cada respuesta lleva un encabezado X-Curriculo-Request-Id ; citalo cuando nos contactes.

Formatos de error

Rechazos en el borde (autenticación, crédito, límite de velocidad, solicitud sobredimensionada) devuelven:

{"success": false, "error": "...", "message": "..."}

Los errores que se producen durante el procesamiento devuelven:

{"detail": "..."}

En una solicitud de lista, un elemento fallido lleva su propio error dentro de results, y el HTTP estado de la solicitud permanece 200. Consulta Procesamiento por lotes.

Códigos de estado HTTP

EstadoSignificadoQué hacer
400La entrada es inutilizable: archivo vacío, texto en blanco, documento ilegible o protegido con contraseña, job_detailsmalformado, una claveJSON duplicada. Para una tarea de grabación, no hay suficiente crédito para reservar el máximo de 2 horas.Corrija la carga útil o agregue crédito. Volver a intentar los mismos bytes fallará de la misma manera.
401"TokenAPI faltante…", "TokenAPI no válido." (clave desconocida o revocada), "TokenAPI expirado.", o "Punto de conexiónAPI desconocido" para una ruta bajo /public/ que no existe.Verifique el encabezado Authorization , la clave y la ruta.
403La clave es válida pero la cuenta no puede servir tráfico: no hay crédito prepagado ("...Compre créditos en la Consola."), la cuenta está suspendida, o "Provisionamiento de cuenta incompleto".Agregue crédito en la Consola → Facturación, o espere a que se termine el provisionamiento. Si la cuenta está suspendida, contáctenos.
404Desconocido job_id, o registrado por una cuenta diferente. También un id de tarea desconocido, o una ruta fuera /public/.Registre el trabajo nuevamente; los id están limitados al credencial que los creó. Verifique la baseURL.
413Superar el techo de tamaño: cuerpo de la solicitud, documento, grabación, longitud de lote o recuento de caracteres.Divida la carga de trabajo o envíe grabaciones por enlace. Consulte los límites de tamaño de solicitud.
422La validación del esquema ha fallado: un campo requerido está faltante o mal nombrado. También un idioma de traducción fuera de los 85 códigos admitidos.Compare con la especificación OpenAPI. Los nombres de los campos son sensibles a mayúsculas y minúsculas. Consulte Idiomas.
429Se excedió el límite de velocidad.Retroceda y reintente. Respete Retry-After cuando esté presente.
500Nuestro error.Reintente una vez. Si persiste, contáctenos con el X-Curriculo-Request-Id.
503Una dependencia no está disponible o una función no está habilitada aquí (por ejemplo, transcripción de medios).Reintente con retroceso.
504El procesamiento superó el límite de 300 segundos.Envíe menos elementos o un documento más pequeño, o utilice el carril asíncrono .

Las solicitudes fallidas nunca se cobran. Un 4xx o un 5xx no cuesta nada, y tampoco lo hace una tarea en segundo plano fallida.

Guía de reintento

  • No reintente 400,401,403,404,413 o 422 sin cambios. Corrija la solicitud primero.
  • Reintentar con retraso en 429 y 503.
  • Reintentar una vez en 500.
  • En 504, reenviar con menos elementos o un documento más pequeño. En una solicitud de lista, vuelva a enviar solo los elementos que devolvieron una entrada 504 .
  • Reenviar un documento fallido individual es siempre seguro. No puede crear duplicados ni registros incompletos.

Contacto

Escriba a [email protected] con la hora, la operación y el X-Curriculo-Request-Id.

Updated