Execute queries GraphQL no Postman
Envie uma query da GraphQL API pelo Postman com o endpoint, o header do token e um corpo GraphQL, e leia as linhas que a API retorna.
Você pode enviar queries da GraphQL API pelo Postman e ler a resposta ao lado da requisição. O Postman envia a query como uma requisição POST com o seu personal token no header Authorization. Para executar uma query pelo navegador ou com curl, consulte Primeiros passos com a GraphQL API.
Pré-requisitos
- Um personal token. Para criar um, consulte Como criar um personal token.
- O Postman instalado na sua máquina.
- Um workload que recebeu requisições durante a janela de tempo consultada. A query de exemplo lê os dados de requisições dele.
Envie uma query
A query de exemplo lê workloadMetrics, um dataset agregado do endpoint de métricas. Ela soma os bytes enviados aos clientes por bucket de tempo ao longo de sete dias, do mais antigo para o mais recente, e retorna no máximo 10 linhas.
Para enviar a query pelo Postman:
No Postman, selecione + para abrir uma requisição.
Selecione GET para abrir a lista de métodos e, depois, selecione POST.
No campo Enter URL or paste text, digite o endpoint de métricas:
Para dados brutos, como workloadEvents, digite https://api.azion.com/v4/events/graphql em vez disso. O endpoint de cada dataset está em Queries.
Na aba Headers, selecione Bulk Edit e digite a linha abaixo. Substitua [TOKEN VALUE] pelo seu personal token:
Mantenha o prefixo Token. Com Bearer, a API retorna 401 com Authentication credentials were not provided.
Na aba Body, selecione GraphQL.
Na caixa de query, digite a query. Defina tsRange como uma janela em que o seu workload recebeu requisições:
O nome de dataset httpMetrics está obsoleto; use workloadMetrics, que retorna as mesmas linhas.
Selecione Send.
O Postman mostra a resposta da API, 200 com as linhas em JSON. A query retorna até 10 linhas. A resposta está cortada depois da terceira:
Leia a resposta
A chave data contém um array com o nome do dataset, com um objeto por linha e apenas os campos que a query selecionou:
| Campo | Valor |
|---|---|
ts | O início do bucket de tempo, em UTC, indicado pelo sufixo Z. Em uma janela de sete dias, cada bucket tem uma hora. |
sum | A saída de aggregate: {sum: bytesSent}: os bytes enviados aos clientes durante o bucket. |
Um bucket sem requisições não retorna linha, então as linhas pulam as horas sem tráfego. O tamanho do bucket acompanha a duração da janela, como descreve Como a GraphQL API funciona.
Uma query recusada retorna um objeto JSON com uma única chave detail, que contém a mensagem. Para cada mensagem e a sua causa, consulte Respostas de erro.
Para mais queries que você executa da mesma forma, consulte aziontech/azion-queries, o repositório da Azion com exemplos de queries da GraphQL API.