Erros | API Converte Extrato

Formato

Os erros usam os códigos de status HTTP padrão. O corpo traz um code estável e uma message legível:

json

{
  "error": {
    "code": "PERMISSION_DENIED",
    "message": "This API key lacks the jobs:write permission."
  }
}

Use o code nas suas condições, não a message. As mensagens podem mudar e estão sempre em inglês.

Status	Código	Significado
400	`INVALID_BODY`	O corpo não é `multipart/form-data`.
400	`INVALID_MODE`	`mode` não é `smart` nem `simple`.
400	`NO_FILES_PROVIDED`	A requisição não tem o campo `files`.
400	`INVALID_FILE_TYPE`	Um arquivo não é PDF, JPEG, PNG nem WebP.
400	`FILE_SIZE_EXCEEDED`	Um arquivo tem mais de 10 MB.
400	`FILE_PAGE_LIMIT_EXCEEDED`	Um arquivo tem mais páginas do que o plano permite por arquivo.
400	`INVALID_LIMIT`	`limit` não é um inteiro de 1 a 100.
400	`INVALID_CURSOR`	`cursor` não é um valor retornado pela API.
401	`INVALID_API_KEY`	A chave de API está ausente, inválida, revogada ou expirada.
402	`PLAN_REQUIRED`	O plano do titular da conta não inclui acesso à API.
402	`QUOTA_EXCEEDED`	O Job tem mais páginas do que restam no plano deste mês.
403	`PERMISSION_DENIED`	A chave de API não tem a permissão que o endpoint exige.
404	`JOB_NOT_FOUND`	Não existe Job com este id na sua conta.
404	`STATEMENT_FILE_NOT_FOUND`	O Job não tem arquivo de extrato com este id.
404	`NOT_FOUND`	Não há endpoint neste caminho dentro de `/v1/jobs/`. Outros caminhos desconhecidos retornam 404 em texto puro.
409	`DUPLICATE_FILE`	Este arquivo já foi convertido nesta conta. Liste os Jobs para encontrá-lo.
409	`JOB_IN_PROGRESS`	O Job ainda está em execução e não pode ser excluído.
429	`RATE_LIMITED`	Requisições demais. Espere os segundos de `Retry-After`.

Tente de novo um 429 depois de Retry-After segundos, e um 5xx com espera exponencial. Não repita outros erros 4xx sem mudar a requisição.