Problemas frequentes
Resolver os problemas mais comuns com o Piloterr.
A maioria dos pedidos de apoio resume-se a um punhado de causas. Percorra primeiro esta página — costuma resolver o problema mais depressa do que esperar por uma resposta.
| Sintoma | Causa mais provável | Correção |
|---|---|---|
Todas as chamadas devolvem 401 | Nome de cabeçalho errado ou um espaço copiado com o segredo | O cabeçalho é x-api-key. Volte a copiar o segredo ou crie uma nova chave. |
401 Rate limit exceeded | Uma quota da chave ou o limite de taxa do seu plano | Distribua o tráfego no tempo, aumente os limites da chave ou mude para um plano superior. |
As chamadas passam subitamente a devolver 402 | Saldo esgotado ou uma fatura por pagar | Compre uma recarga, ative a recarga automática ou regularize a fatura. |
| Tempos limite exatamente aos 10 s ou 30 s | A sua plataforma desiste antes da nossa resposta | Aumente o tempo limite da função ou do cliente para 60 segundos. |
400 num pedido que antes funcionava | Falta um parâmetro obrigatório ou está mal escrito | Compare com a página do endpoint na Referência da API. |
| Os créditos descem mais depressa do que o esperado | Novas tentativas ou um ciclo a chamar o mesmo endpoint | Procure chamadas idênticas repetidas nos registos de pedidos. |
| Saldo ou chaves em falta no painel | Espaço de trabalho errado selecionado | Utilize o seletor no topo da barra lateral. |
| O playground consome créditos de forma inesperada | As chamadas do playground são chamadas de API reais | Use o endpoint de uso gratuito para testar a autenticação, ou o Simulador para estimar o custo sem tráfego. |
402 com créditos ainda visíveis | Uma fatura por pagar está a bloquear a conta | Abra Definições → Faturas, regularize a fatura e tente de novo. |
Lista de verificação de 60 segundos
Leia o código de estado
401 → chave ou limite de taxa. 402 → saldo ou fatura. 400 → parâmetros. 5xx → repetir com backoff.
Encontre a linha em Registros API
Faça corresponder a data e hora. Abra o painel de detalhe para os parâmetros exactos e a mensagem de erro.
Verifique o saldo na barra lateral
Se estiver perto de zero, recarregue ou ative a recarga automática antes de repetir uma carga de produção.
Continua bloqueado
Abra um ticket de suporte em Definições → Suporte → Novo ticket. Indique o endpoint, a data e hora e o código de estado que observou — com estes três elementos, encontramos o pedido em segundos. O API Status, no mesmo menu, diz-lhe se o problema é do nosso lado.