Antes que possa começar de fato os testes com a nossa API, é importante que conheça alguns processos básicos:
💡 #DicaDoBem: Atualmente, conseguimos testar as nossas API’s diretamente pelo site do Developer, porém, existem alguns programas que também podem realizar esse processo, como é o caso do Postman, Insomnia e o ThunderClient (uma extensão do VS Code) |
Para o nosso teste, vamos utilizar diretamente o Developer. Assim como, vamos utilizar o APP KEY e o APP SECRET padrões, mas se preferir, pode alterar para o seu 😉
Nesse artigo, temos:
Obtendo os dados necessários
Para realizar a baixa da conta a pagar será necessário já ter alguns dados para enviar como parâmetros nas requisições
Para a requisição padrão, é necessário já ter:
Código do Lançamento que deseja realizar a baixar:
Código da Conta Corrente em que deseja registrar o recebimento:
Baixando a conta a pagar
Para esse processo utilizaremos o seguinte método: LancarPagamento
Aqui no exemplo, utilizaremos a requisição padrão, conforme abaixo:
{
"codigo_lancamento": 5522010473,
"codigo_baixa_integracao": "001197",
"codigo_conta_corrente": 4243124,
"valor": 100,
"desconto": 0,
"juros": 2,
"multa": 1,
"data": "14/08/2023",
"observacao": "Baixa de documento realizada via API."
}
📌 A tag "codigo_baixa" deve ser informado manualmente e será único para essa baixa específica, como uma espécie de identificador
Mas se quiser, você pode adicionar mais parâmetros disponíveis aqui:
Para realizar o teste, clique em "Executar":
No lado direito você terá disponível algumas informações bem importantes:
2) Requisição cURL: o sistema converte todo o conteúdo preenchido para o envio da requisição em cURL para que você possa utilizar de forma mais prática caso faça integrações por outros aplicativos;
3) Cabeçalho: por aqui é possível acompanhar o status HTTP, e verificar se a requisição deu erro ou se foi concluída com sucesso
4) Corpo: é nessa parte que serão exibidos todos os retornos da requisição enviada.
Prontinho! Sua conta a pagar foi registrada com sucesso!
📌 Separamos alguns artigos relacionados que podem te ajudar bastante: