Códigos HTTP das respostas

Nossa API utiliza respostas HTTP convencionais para indicar sucesso ou falha nas requisições. Respostas com status 200 indicam sucesso, status 4xx indicam falhas decorrentes de erros nas informações enviadas, e status 500 indicam erros internos em nosso servidor.

Código HTTP	Descrição
200 OK	Sua requisição foi bem sucedida.
400 Bad Request	Algum parâmetro obrigatório não foi enviado ou é inválido. Neste caso a própria resposta indicará qual é o problema.
401 Unauthorized	Não foi enviada API Key ou ela é inválida.
403 Forbidden	Requisição não autorizada. Abuso da API ou uso de parâmetros não permitidos podem gerar este código.
403 Forbidden / Cloudfront (GET)	Erros 403 em chamadas GET indicam que você está enviando um `body` junto da requisição. Você não deve enviar nenhuma informação no `body` em chamadas do tipo GET.
404 Not Found	O endpoint ou o objeto solicitado não existe.
429 Too Many Requests	Muitos pedidos em um determinado período de tempo. Mais em nossa seção sobre Rate Limiting.
500 Internal Server Error	Algo deu errado no servidor do Asaas.

Todos os endpoints da API recebem e respondem em JSON.

Exemplo de resposta para HTTP 400:

{
    "errors":[
        {
            "code":"invalid_value",
            "description":"O campo value deve ser informado"
        },
        {
            "code":"invalid_dueDate",
            "description":"A data de vencimento não pode ser inferior à hoje"
        }
    ]
}