O Asaas utiliza códigos de resposta HTTP convencionais para indicar se uma requisição à API foi bem-sucedida ou se apresentou algum erro.
Quando o erro ocorre no momento do envio da chamada (como na criação de uma cobrança), a causa está no envio da requisição.
Códigos de resposta:
200 OK: A requisição foi bem-sucedida.
400 Bad Request: Algum parâmetro obrigatório não foi enviado ou é inválido. A própria resposta indicará qual parâmetro precisa de ajuste.
401 Unauthorized: Falha na autenticação. A chave de API não foi enviada, é inválida ou não pertence ao ambiente correto (Sandbox ou Produção).
403 Forbidden: Requisição não autorizada. Pode ocorrer por abuso da API ou uso de parâmetros não permitidos.
404 Not Found: O endpoint ou o objeto solicitado não existe.
429 Too Many Requests: O limite de requisições da conta foi atingido em uma janela de tempo. Verifique os headers
RateLimit-Limit,RateLimit-RemainingeRateLimit-Resetpara saber quando novas chamadas poderão ser feitas.500 Internal Server Error: Ocorreu um erro no servidor do Asaas.
Se você encontrar alguma mensagem de erro ou código HTTP e precisar de suporte para identificar a causa, consulte os conteúdos específicos em:
- Erro 400 Bad Request: https://docs.asaas.com/docs/error-400-bad-request
- Erro 403 Forbidden: https://docs.asaas.com/docs/error-403-forbidden
- Erro 404 Not Found: https://docs.asaas.com/docs/error-404-not-found
- 500 Internal Server Error: https://docs.asaas.com/docs/error-500-internal-server-error
- Read Timed Out: https://docs.asaas.com/docs/error-408-read-timed-out
- Connect Timed Out: https://docs.asaas.com/docs/connect-timed-out-error
- Outros erros de webhook: https://docs.asaas.com/docs/other-errors