Códigos de erro

Um erro responde sempre com um código de estado HTTP e um corpo JSON:

{ "error": "Mensagem legível", "code": "internal_error" }

error descreve o problema; code só está presente em alguns erros e não muda de uma versão para outra.

Estado	Significado	O que fazer
400	Corpo inválido, campo obrigatório vazio ou company_id que não é composto por 32 caracteres hexadecimais.	Corrigir o pedido.
401	company_id ausente, ou valor do cabeçalho diferente do valor do corpo.	Verificar o cabeçalho Authorization.
402	Créditos insuficientes para lançar o percurso. O candidato não foi contactado.	Carregar os créditos da empresa e voltar a lançar.
409	A oferta já está associada a outra empresa (ats_offer_owned_by_another_org).	Verificar o identificador da oferta e a empresa que faz a chamada.
422	Nenhuma sessão criada num lote: todos os candidatos foram recusados.	Ler os motivos devolvidos e corrigir os dados.
500	Erro interno (code: internal_error), sem detalhe.	Tentar novamente mais tarde. Uma atribuição pode ser repetida sem risco de duplicados.

Motivos de recusa num lote

Num lote, cada candidato recusado aparece em failed com o respetivo motivo (reason) e, quando existe, um detalhe legível (detail):

Motivo	Significado
INVALID_DATA	Telefone impossível, endereço de e-mail em falta ou data de chamada ilegível.
DUPLICATE_PHONE_IN_BATCH	O mesmo número aparece duas vezes no lote.
DUPLICATE_ACTIVE_SESSION	O candidato já tem uma sessão ativa para esta avaliação.
INSUFFICIENT_CREDITS	A empresa já não tem créditos suficientes.