Como rodar requisições da GraphQL no Postman

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.

Contribuidores