Erros & FAQ

Respostas para dúvidas comuns e guia de troubleshooting.

Erros Comuns

401 Unauthorized

Chave inválida, ausente ou de ambiente incorreto (ex.: usar uma chave fb_sandbox_ no ambiente de produção, ou vice-versa).

Solução: Verifique se o header api-key está correto e corresponde ao ambiente. A autenticação usa apenas o header api-key — em todos os métodos (GET, POST, PUT, PATCH, DELETE). Não é necessário enviar timestamp nem signature.

429 Too Many Requests

Limite de taxa excedido.

Solução: Aguarde antes de fazer novas requisições. Implemente retry com backoff exponencial respeitando os headers X-RateLimit-*.

400 Bad Request

Requisição inválida.

Solução: Verifique os parâmetros enviados. Consulte o payload esperado na documentação.

422 Unprocessable Entity

Dados inválidos ou inconsistentes.

Solução: Valide os dados antes de enviar. Ex: montante deve ser positivo, endereço wallet válido.

503 Service Unavailable

Serviço temporariamente indisponível.

Solução: Implemente retry automático com backoff.