Gerando chave para chamadas de API
Passo a passo detalhado para auxiliar na criação da chave e consulta de dados através da API:
-
Gerando a chave pública (PAYLOAD):
# Linux curl -X POST 'https://api.skymail.net.br/v1/auth/login' --data "username=nomedeusuario@dominio.com.br&password=senhadousuario" 'cache-control: no-cache' # Windows Invoke-RestMethod -Method Post -Uri "https://api.skymail.net.br/v1/auth/login" -Headers @{ "Cache-Control"="no-cache" } -ContentType "application/x-www-form-urlencoded" -Body "username=email@dominio.com&password=senha"Retorno esperado:
{"success":true,"data":{"jti":"resultadodopasso1"},"message":"Token p\u00fablico de autentica\u00e7\u00e3o gerado com sucesso"} - Consultar a chave privada no painel (SIGNATURE):
-
Construindo o token JWT:
Baixe o arquivo token-generator.ps1 e execute o mesmo no Powershell.
Após a execução ele irá solicitar o "JTI" juntamente com a "SECRET KEY" que coletamos nos passos anteriores:Conforme a imagem acima o TOKEN será gerado com sucesso!
Caso ocorra erro de permissão no Windows, execute: Set-ExecutionPolicy Bypass no Powershell.
-
O resultado "TOKEN JWT" é o jwt.token.generated para utilizar nas chamadas curl, por exemplo:
# curl -X GET 'https://api.skymail.net.br/v1/client' -H 'Authorization: bearer token gerado' 'cache-control: no-cache' > {"success":true,"data":[{"clientId":0,"name":"Exemplo","taxNumber":"000","creationDate":"2022-01-01 10:00:00"}],"page":1,"perPage":50,"numPages":1,"total":1}