Configurando o Postman para testes de API Maestrus.

Olá! Tudo bem?
 
Nesse tutorial iremos demonstrar como configurar o Postman para testes de API Maestrus.
 
Vamos lá!
 
1 - Acesse seu painel Maestrus > menu Site > API. Clique em "Novo Token":
 
IMAGEM 1
 
Salve esse token pois iremos utilizar mais adiante!

Para fins didáticos, pegamos como base a ação de matricular um usuário via API.
 
2 - Acesse sua conta no Postman. Depois acesse ou crie um Workspace.
 
Dentro de um Workspace, clica no ícone de "+" para criar uma nova coleção.
 
IMAGEM 2
 
No campo de métodos, escolha "POST" e monte a URL conforme o tipo de ação que deseja testar (veja sua URL do Endpoint correspondente em seu Maestrus).
 
IMAGEM 3
 
IMAGEM 4
 
3 - Agora vamos seguir para as próximas configurações do Postman.
 
- na aba "Params" você não irá alterar nada.
- na aba "Authorization" você irá deixar "Type: No Auth".

IMAGEM 5
 
- na aba  "Headers" você irá deixar:
    -- coluna KEY = Content-Type ---->  coluna VALUE = application/json
    -- coluna KEY = x-hub-signature ---> coluna VALUE = {{h-max}}
 
IMAGEM 6
 
- na aba "Body", deixe marcado a opção "raw", e aqui você irá inserir a estrutura conforme o exemplo da rotina (Matrículas Externas por Postback, Login externos de parceiros ou Listar Leads). Em nosso tutorial iremos adotar o endpoint de matrículas:
 
 
IMAGEM 7
 
Nesse exemplo, temos:
- action = significa o status da matrícula.
- kind = significa o tipo de produto Maestrus. Nesse caso, trata-se de um curso.
- product_id = significa o ID do produto Maestrus. Nesse caso, trata-se do ID do curso.
- email = significa o email do aluno que será matriculado no curso.
 
 
- na aba "Pre-request Script" você irá inserir o seguinte código:
 
 
postman.setEnvironmentVariable("hmac", "sha1=" + CryptoJS.HmacSHA1(request.data, "MEU_TOKEN").toString(CryptoJS.digest));
 
No lugar de MEU_TOKEN, você irá inserir o token criado no item 1 desse tutorial.
 
IMAGEM 8
 
Nas demais abas "Tests" e "Settings" não será necessário nenhuma configuração.
 
4 - Feito isso, basta clicar na opção "Send" para disparar o evento.
 
IMAGEM 9
 
 
E assim finalizamos esse tutorial.
 
Qualquer dúvida, entre em contato com nossa equipe de suporte!

Última atualização: 21/02/2022 15:44:00

Vamos conversar? Fale com um especialista.

Vá para o topo