Como rodar requisições da GraphQL no Postman

Você pode rodar requisições da GraphQL direitamente no Postman e receber respostas.

Ver como Markdown

Você pode rodar requisições da GraphQL API direitamente no Postman ou em outras plataformas de API. Para usar o Postman, você precisa completar dois passos: ⁠criar um personal token e rodar sua requisição no Postman. Veja as próximas seções e siga os passos apresentados.

Crie um personal token

Antes de rodar suas requisições com a GraphQL API⁠, você deve criar um personal token na Azion para validar seu acesso.

  1. No Azion Console, no canto superior direito, selecione Account menu > Personal Tokens.
  2. Preencha os campos para configurar o personal token e clique no botão Create Token.
  3. Copie e salve seu token em um local seguro para utilizá-lo na próxima seção.

Veja a documentação de Personal Tokens para mais informações sobre como criar tokens.

Como alternativa, você pode criar um token de curta duração usando a API da Azion.

Rode requisições no Postman

Após criar seu personal token, vá para o Postman e siga os próximos passos:

  1. No cabeçalho, clique no botão + para criar uma nova requisição.
  2. Na aba Headers, clique em⁠ Bulk Edit e adicione o código a seguir, substituindo [TOKEN VALUE] pelo valor do personal token que você criou:
Authorization: Token [TOKEN VALUE]

Continue no Postman para criar o corpo da requisição:

  1. Selecione a aba Body.
  2. No canto superior esquerdo, clique na opção GET para abrir um menu suspenso.
  3. Selecione a opção POST.
  4. No campo Enter URL or paste text, adicione a URL sendo consultada: https://api.azionapi.net/metrics/graphql ou https://api.azionapi.net/events/graphql
  5. Na linha de opções, selecione GraphQL.
  6. Na caixa de código, adicione a query que você quer utilizar. Por exemplo:
query HttpQuery {
httpMetrics(
limit: 10,
filter: {
tsRange: {begin:"2022-03-21T10:10:10", end:"2022-06-23T10:10:10"}
}
aggregate: {sum: bytesSent}
groupBy: [ts]
orderBy: [ts_ASC]
)
{
ts
sum
}
}
  1. Clique no botão Send no canto superior direito.

Você receberá uma resposta com os dados solicitados, semelhante a:

{
"data": {
"httpMetrics": [
{
"ts": "2022-06-09T21:33:13",
"sum": 1471.0
},
{
"ts": "2022-06-09T21:33:14",
"sum": 1471.0
},
{
"ts": "2022-06-09T21:33:15",
"sum": 1471.0
}
]
}
}

Você encontra exemplos de queries no repositório do⁠GitHub azion-queries.