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!