Autenticación automática 2.0
El acceso a la API requerirá la autenticación OAuth 2.0 que, a su vez, requerirá un usuario técnico para un distribuidor en particular en el sistema de autenticación de Schneider.
Para solicitar credenciales, envíe un correo electrónico a: distribuidorapiportal.global@se.com
Cómo funciona OAuth:
- El usuario de la API debe tener una identificación de cliente estática y una clave secreta junto con el punto final de generación de tokens del proveedor de la API.
- Usando los detalles anteriores, la API de token debe llamarse con el método POST.
- Esta API devolverá el token Bearer, que se puede usar durante 1 hora para llamar a la API, esto se puede tratar como una credencial dinámica que vence en una hora.
Ambiente | Endpoint de generación de tokens |
Explorar | https://api.explore.se.com/token |
Dev | https://api.dev.se.com/token |
QA | https://api.qa.se.com/token |
Pre-prod | https://api.preprod.se.com/token |
Production | https://api.se.com/token |
Cómo generar token usando Postman:
- Crear una nueva solicitud de API con un punto final de API real
- Ir a la sección de Autorización
- Seleccione Tipo como OAuth 2.0
- En el lado derecho, vaya a Configurar nuevo token
- El nombre del token puede ser definido por el usuario (por ejemplo, el nombre del distribuidor)
- Tipo de concesión = Credenciales del cliente (seleccione del menú desplegable)
- La URL del token de acceso será según la tabla anterior
- El ID del cliente y el secreto del cliente serán proporcionados por el equipo de Schneider
- Alcance todo
- La autenticación del cliente puede ser Enviar credenciales de cliente en el cuerpo
- Haga clic en Obtener nuevo token de acceso
Muestra de generación de token usando una nueva solicitud de cartero:
Seleccione POST e ingrese la URL del token.
En la pestaña Cuerpo, haga clic en el botón de radio x-www-form-urlencoded.
Introduzca manualmente la clave y el valor, "grant_type" y "client_credentials".
En la pestaña Autorización, seleccione Tipo "Autenticación básica".
Establezca el Nombre de usuario en la clave del cliente (que se le proporciona sin conexión).
Establezca la contraseña en el secreto del cliente (que se le proporciona sin conexión).
Envíe la solicitud y recupere el valor de access_token del mensaje de respuesta.
Creación de solicitudes de generación de tokens usando CURL en Postman:
En cartero, seleccione la opción Importar (que se encuentra en la parte superior izquierda).
En el cuadro de diálogo Importar, seleccione Texto sin procesar y pegue la muestra de curvatura que se proporciona a continuación.
Haga clic en Continuar y luego en Importar.
En la pestaña Encabezados, reemplace el valor de Autorización con la cadena codificada en Base-64 de client_key y client_secret.
Curl de muestra para generación de tokens:
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'
Clave API
Para algunas API, el acceso mediante la clave de API también es factible cuando proporciona la clave de API de larga duración como parámetro de consulta.
Una vez que tenga una apikey, puede ejecutar operaciones GET directamente en un navegador web.
Formato de URL: https://{hostname}/{BaseURL}/{ResourcePath}?{queryParams}&apikey={your_api-key}