How to query GraphQL requests on Postman

You can query GraphQL requests directly on Postman and receive responses.

View as Markdown

You can query GraphQL API requests on Postman or other API platforms. To use Postman, you need to go through two steps: create a personal token and run your request on Postman. See the next sections and follow the presented steps.

Creating a personal token

Before running your requests with the GraphQL API, you first need to create a personal token on Azion to validate your access.

  1. On Azion Console, on the upper-right corner, select Account menu > Personal Tokens.
  2. Fill the fields to configure the personal token and click the Create Token button.
  3. Copy and save your token in a safe location to use it in the next section.

See the Personal Tokens documentation for more information on how to create one.

As an alternative, you can create a short-duration token through the Azion API.

Querying on Postman

After creating your personal token, go to Postman and follow the next steps:

  1. On the header, click the + button to create a new request.
  2. On the Headers tab, click on Bulk Edit and add the following code, replacing [TOKEN VALUE] with the personal token value you created:
Authorization: Token [TOKEN VALUE]

Remain on Postman and create the request’s body:

  1. Select the Body tab.
  2. On the upper-left corner, click the GET option to open a dropdown menu.
  3. Select the POST option.
  4. On the Enter URL or paste text field, add the URL being queried: https://api.azionapi.net/metrics/graphql or https://api.azionapi.net/events/graphql
  5. On the options row with radio buttons, select the GraphQL option.
  6. On the code box, add the query you want to use. For example:
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. Click the Send button on the upper-right corner.

You’ll receive a response with the requested data, similar to this:

{
"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
}
]
}
}

You can find queries examples on the GitHub azion-queries repository.