Primeiros Passos API GraphQL
Veja como acessar a API GraphQL da Azion e o playground da GraphQL.
1. Acessar a API GraphQL
Para utilizar a API GraphQL com plataformas de API, como Postman e Insomnia, você precisa autenticar seu acesso para garantir que os requests sejam realizados de forma segura. A autenticação ocorre através do uso de Tokens.
Para criar um Token, você tem duas opções:
- Utilizar a plataforma de API da Azion.
- Usar o Real-Time Manager (RTM).
A primeira opção é criar um Token através da plataforma de API da Azion. Vá até Token e execute o seu request.
A segunda opção é criar um Personal Token através da interface de configuração da Azion, Real-Time Manager (RTM). Essa opção pode ser mais adequada para uso com APIs, pois proporciona a criação de um token de longa duração. Veja a página de documentação de Personal Tokens para mais informações.
Ao criar um Personal Token, você deve informar uma data de expiração. Para uso com APIs, é recomendado usar uma data de expiração mais longa, como 90 dias ou 1 ano. Nesse caso, tome as medidas necessárias para garantir a segurança do seu projeto.
Após criar o seu Personal Token, vá para a plataforma de API de sua escolha e inclua o endpoint da API GraphQL da Azion em seu request:
- Para usar a API Metrics com dados agregados, inclua:
https://api.azionapi.net/metrics/graphql - Para usar a API Events com dados brutos, inclua:
https://api.azionapi.net/events/graphql
2. Acessar o playground GraphQL
Você pode usar o playground da GraphQL da Azion para escrever, validar e testar queries da GraphQL. Usar o playground também ajuda a conhecer melhor a API e o uso de queries de forma visual e rápida.
Para interagir com o playground da GraphQL, você deve estar logado no RTM. Se você ainda não criou uma conta, veja a página de documentação Criar uma conta na Azion.
Após fazer login no RTM, acesse https://manager.azion.com/metrics/graphql ou https://manager.azion.com/events/graphql para interagir com o playground da GraphQL.
Assista um tutorial sobre os primeiros passos da GraphQL no canal do YouTube da Azion, com opção de ativar legendas em português:
Não encontrou o que procurava? Abra um ticket.