Tratamento de Erros

Consulte autenticação para a configuração da chave de API, e importação de CAR para uploads em lote — ambos os fluxos podem retornar os erros documentados nesta página.

Todos os erros retornam um objeto JSON com um campo error:

{
  "error": "not enough storage, please upgrade your plan"
}

Códigos de status

Código	Significado	Causas comuns
400	Requisição Invalida	Parâmetros ausentes ou invalidos, tipo de conteúdo não suportado, corpo JSON inválido.
401	Não Autorizado	Chave API ausente ou inválida.
402	Pagamento Necessário	Limite de armazenamento excedido — faça upgrade do seu plano ou aguarde o reset mensal.
404	Não Encontrado	CID do arquivo ou usuario não encontrado.
429	Muitas Requisições	Limite de largura de banda do gateway excedido — aguarde o reset mensal.
500	Erro Interno	Erro inesperado do servidor — tente novamente ou entre em contato com o suporte.

Erros 4xx do Cliente

Códigos 4xx indicam um problema com a própria requisição. Verifique se a sua chave de API é válida (401), se o corpo da requisição está em JSON corretamente formatado (400), e se sua cota de armazenamento não foi excedida (402). Esses erros não são recuperáveis com uma simples nova tentativa — corrija a requisição antes de reenviar.

Erros 5xx do Servidor

Uma resposta 500 indica uma condição inesperada do lado do servidor. Tente novamente a requisição após um breve intervalo; se o erro persistir, entre em contato com o suporte informando o ID da requisição presente nos cabeçalhos da resposta.