Códigos de estado
Códigos de estado HTTP retornados pela API Chartquery e como tratá-los.
As chamadas síncronas são cobradas no 200. As chamadas assíncronas (is_async=true) retornam um 202 (não cobrado) e são cobradas quando o trabalho termina com sucesso — registado como 201 nos seus registos de pedidos. A consulta GET /jobs/{job_id} é sempre gratuita. Os trabalhos falhados (500) nunca são cobrados. A cobrança do 404 varia por endpoint (verifique a página de cada endpoint). Todas as outras respostas 4xx/5xx são gratuitas.
| Código | Cobrado | Estado | Ação |
|---|---|---|---|
200 | Sim | Chamada de API bem-sucedida (síncrona) | Nenhuma ação necessária. |
201 | Sim | Trabalho assíncrono concluído | Aparece nos seus registos de pedidos quando um trabalho assíncrono termina com sucesso — é nesse momento que o trabalho é cobrado. Nunca é retornado como resposta HTTP. |
202 | Não | Aceite (assíncrono) | O trabalho foi aceite e enfileirado. Consulte GET /jobs/{job_id} para obter o resultado — a consulta é sempre gratuita. |
400 | Não | Pedido incorreto | Verifique os seus parâmetros e os seus tipos. Consulte a documentação para mais informações. |
401 | Não | Chave de API inválida | Verifique a sua chave de API (cabeçalho x-api-key ou string de consulta x_api_key). |
401 | Não | Chave de API inativa | Ative a sua chave de API na secção Chaves API das Definições da sua conta. |
401 | Não | Chave de API expirada | Atualize a sua chave de API ou gere uma nova. |
401 | Não | Rate limit exceeded | Aguarde e tente novamente. Faça upgrade do plano ou aumente as cotas por chave se isso ocorrer com frequência. |
402 | Não | Payment required | Recarregue créditos, faça upgrade do plano, ative a Recarga automática ou quite as faturas em aberto. |
403 | Não | Proibido | Verifique as suas permissões. Para API Stats, HTTP 403 significa que o endpoint não está ativado na sua conta: contacte o suporte para o ativar. |
404 | Varia | Não encontrado | A cobrança é específica de cada endpoint. Consulte a página do endpoint correspondente. |
413 | Não | Carga muito grande | O ficheiro enviado ou o corpo do pedido excede o limite de tamanho. Consulte a documentação para os tamanhos máximos. |
500 | Não | Erro interno | Repita a ação ou contacte a nossa equipa de suporte. |