Guia de autenticação

Visão Geral

Para acessar os recursos da API Grafeno Ativos, é necessário autenticar-se utilizando um token de autenticação. O token é obtido através de uma chamada à nossa API de autenticação, passando um client_id e um client_secret no corpo da requisição. O token gerado tem validade de 24 horas.

Passo a Passo para Obter o Token de Autenticação

1. Gerar client_id e client_secret: Antes de fazer a solicitação do token, é necessário gerar as credenciais de cliente. Siga os passos a seguir para gerar essas credenciais: Acesse a sua conta na plataforma Grafeno 360 >>> No canto superior direito da tela, clique no seu perfil >>> navegue até "Gestão de empresa" >>> acesse "Minha conta" >>> selecione "Chaves de API" >>> clique em "Criar uma nova chave" >>> informe um nome para a chave e clique em "Criar Chave". O client_id e o client_secret serão apresentados em tela. Anote essas informações, pois o client_secretnão poderá ser recuperado posteriormente.
2. Obter o Token de Autenticação: Após obter o client_id e o client_secret, faça uma requisição para a nossa API de autenticação para gerar o token de autenticação. Utilize o seguinte formato:

curl --location 'https://apis.stg.grafeno.be/auth/v1/authorize' \
--header 'Content-Type: application/json' \
--data '{
    "client_secret": "aaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "client_id": "11111111-2222-3333-4444-555555555555"
}'

Se a requisição for bem-sucedida, você receberá uma resposta com o token de autenticação:

{  
    "access_token": "seu_token_de_acesso"
}

🚧

Importante

• Validade do Token: O token gerado tem uma validade de 24 horas. Após esse período, será necessário solicitar um novo token.
• Segurança: Mantenha o client_secret seguro. Caso ele seja comprometido, gere novas credenciais imediatamente e exclua as credenciais existentes.