Skip to content
CurriculoCurriculo ATS DocumentationDocs
API referenceConsole

Erros

On this page

Erros são JSON e carregam o HTTP status que importa. Nada falha silenciosamente: uma solicitação rejeitada informa o motivo. Cada resposta carrega um cabeçalho X-Curriculo-Request-Id ; cite-o quando nos contatar.

Formatos de erro

Rejeições na borda (autenticação, crédito, limite de taxa, solicitação de tamanho excessivo) retornam:

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

Erros levantados durante o processamento retornam:

{"detail": "..."}

Em uma solicitação de lista, um item com falha carrega seu próprio erro dentro do results, e o HTTP status da solicitação permanece 200. Consulte Loteamento.

códigos de HTTP status

StatusSignificadoO que fazer
400A entrada é inutilizável: arquivo vazio, texto em branco, documento ilegível ou protegido por senha, job_detailsmalformado, uma chave JSON duplicada. Para uma tarefa de gravação, não há crédito suficiente para reservar o máximo de 2 horas.Corrija a carga, ou adicione crédito. Repetir bytes idênticos falhará de forma idêntica.
401"Token API ausente…", "Token API inválido." (chave desconhecida ou revogada), "Token API expirado.", ou "Ponto de extremidade API desconhecido" para um caminho sob /public/ que não existe.Verifique o cabeçalho Authorization , a chave e o caminho.
403A chave é válida, mas a conta não pode servir tráfego: nenhum crédito pré-pago ("…Compre créditos no Console."), a conta está suspensa, ou "Provisionamento de conta incompleto".Adicione crédito no Console → Faturamento, ou aguarde até que o provisionamento seja concluído. Se a conta estiver suspensa, entre em contato conosco.
404job_iddesconhecido, ou registrado por uma conta diferente. Também um ID de tarefa desconhecido, ou um caminho fora /public/.Registre o trabalho novamente; IDs são limitados à credencial que os criou. Verifique a base URL.
413Acima do teto de tamanho: corpo da solicitação, documento, gravação, comprimento do lote ou contagem de caracteres.Divida a carga de trabalho, ou envie gravações por link. Consulte os limites de tamanho de solicitação .
422A validação do esquema falhou: um campo obrigatório está faltando ou mal nomeado. Além disso, um idioma de tradução fora dos 85 códigos suportados.Compare com a especificação OpenAPI. Os nomes dos campos diferenciam maiúsculas de minúsculas. Consulte Línguas.
429Limite de taxa excedido.Aguarde e tente novamente. Respeite Retry-After quando presente.
500Falha interna.Tente novamente uma vez. Se persistir, entre em contato conosco com o X-Curriculo-Request-Id.
503Uma dependência está indisponível ou um recurso não está habilitado aqui (por exemplo, transcrição de mídia).Tente novamente com intervalo.
504O processamento ultrapassou o limite de 300 segundos.Envie menos itens ou um documento menor, ou use a via assíncrona .

Solicitações com falha nunca são cobradas. Um 4xx ou 5xx não tem custo, assim como uma tarefa em segundo plano com falha.

Orientação para nova tentativa

  • Não tente novamente 400,401,403,404,413 ou 422 sem alterações. Corrija a solicitação primeiro.
  • Tente novamente com backoff em 429 e 503.
  • Tente novamente uma vez em 500.
  • Em 504, reenvie com menos itens ou um documento menor. Em uma solicitação de lista, reenvie apenas os itens que retornaram uma entrada 504 .
  • Reenviar um único documento com falha é sempre seguro. Não pode gerar duplicatas ou registros incompletos.

Contato

Escreva para [email protected] com a hora, a operação e o X-Curriculo-Request-Id.

Updated