Autenticação

OAuth 2.0
O acesso à API exigirá autenticação OAuth 2.0 que, por sua vez, exigirá usuário técnico para um distribuidor específico no sistema de autenticação Schneider.
Para solicitar credenciais, envie um email para: distribuidorapiportal.global@se.com

Como o OAuth funciona:

1. O usuário da API precisa ter um ID de cliente estático e uma chave secreta junto com o endpoint de geração de token do provedor de API.
2. Usando os detalhes acima, a API Token precisa ser chamada com o método POST.
3. Essa API retornará o token Bearer, que pode ser usado por 1 hora para chamar a API, isso pode ser tratado como credencial dinâmica que tem validade de uma hora.

Como gerar token usando o Postman:

1. Criar nova solicitação de API com endpoint de API real
2. Vá para a seção Autorização
3. Selecione o tipo como OAuth 2.0
4. No lado direito, vá para Configurar Novo Token
5. O nome do token pode ser definido pelo usuário (por exemplo, nome do distribuidor)
6. Tipo de concessão = Credenciais do cliente (selecione na lista suspensa)
7. A URL do token de acesso será conforme a tabela acima
8. O ID do cliente e o segredo do cliente serão fornecidos pela equipe da Schneider
9. Escopo todos
10. A autenticação do cliente pode ser Enviar credenciais do cliente no corpo
11. Clique em Obter novo token de acesso

Amostra de geração de token usando a nova solicitação do Postman:

Selecione POST e insira a URL do token.
Na guia Corpo, clique no botão de opção x-www-form-urlencoded.
Insira manualmente a Chave e o Valor, “grant_type” e “client_credentials”.
Na guia Autorização, selecione Tipo “Autenticação básica”.
Defina o nome de usuário para a chave do cliente (fornecida offline).
Defina a senha para o segredo do cliente (fornecido a você offline).
Envie a solicitação e recupere o valor de access_token da mensagem de resposta.

Criação de solicitação de geração de token usando CURL no Postman:

No carteiro, selecione a opção Importar (que fica no canto superior esquerdo).
Na caixa de diálogo Importar, selecione Texto bruto e cole a amostra de curvatura fornecida abaixo.
Clique em Continuar e depois em Importar.
Na guia Headers, substitua o valor Authorization pela string codificada em Base-64 de client_key e client_secret.

 
Exemplo de curl para geração de token:
curl --location --request POST 'https://api.se.com/token' \
--header 'Authorization: Basic askjdfsaldalskjfdlsajflasdkjfb2h4NVJxMFlSZ2hUbA==' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials'

Chave API
Para algumas APIs, o acesso usando a chave de API também é viável quando você fornece a apikey de longa duração como um parâmetro de consulta.
Depois de ter um apikey, você pode exercer operações GET diretamente em um navegador da web.
Formato de URL: https://{hostname}/{BaseURL}/{ResourcePath}?{queryParams}&apikey={your_api-key}