¿Cómo consumir la API Manager?

Introducción

La API Manager sigue siendo funcional en el API Management (Sensedia Platform), pero con algunos cambios: la URL ha cambiado y también la forma de autenticación.

Ahora, la URL base es única:

https://platform-production.sensedia.com/api-manager/api/v3/

Para acceder a las diversas operaciones disponibles (consulte el Swagger para ver la lista completa), siempre debe enviar un header Authorization con el valor en el formato:

Bearer <token>

Es a través del token que identificamos el tenant y devolvemos la información correcta en la solicitud.

Resumiendo

En las solicitudes, envíe el header:

Authorization: Bearer <token>

Recuerde dejar un espacio entre "Bearer" y el token y reemplace <token> por su token de acceso (vea abajo cómo generarlo).

Cómo generar el token

Para generar el token, necesita un client ID y un client secret válidos. Para obtenerlos, siga los pasos abajo.

  • Solo los usuarios Super Admin pueden generar el token de acceso.

  • El token de acceso expira en 24 horas (86400 segundos).

  1. Acceda a Access Control.

  2. En la esquina superior derecha, haga clic en el nombre de su usuario y acceda a la opción ACCOUNT SETTINGS:

    user account settings dropdown

  3. En la pestaña CREDENTIALS, haga clic en GENERATE CREDENTIALS para generar las credenciales.

    credentials tab generate button

Entonces podrá visualizar y copiar el client ID y el client secret, mostrados como en la imagen a continuación:

credentials generated with curl

Después de salir de la pestaña, podrá volver a visualizar el client ID, pero el client secret ya no será visible por razones de seguridad. Guárdelo de forma segura o revoque la credencial actual y genere una nueva si es necesario.

Generando el token con curl

Ahora es necesario enviar estas credenciales al servidor de autorización para generar el token. Para facilitar, se proporciona un comando curl en la pantalla, que puede ser usado directamente en el terminal, Postman u otra aplicación.

La respuesta de este comando contendrá el token, como en el ejemplo a continuación:

{
  "access_token": "<token>",
  "expires_in": "86400",
  "token_type": "Bearer"
}

Uso del token

Copie el valor del campo "access_token" (su token) y envíelo en las solicitudes HTTP con el header:

Authorization: Bearer <token>

De esta manera, sus solicitudes a la API Manager funcionarán correctamente en el API Management (Sensedia Platform).

Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]