¿Cómo invocar APIs de gestión de la plataforma con Token OAuth2?
- DevPortal Editor (Unlicensed)
- Onesait Platform
La plataforma permite invocar a las APIs con el/los tokens propios del usuario, o bien con un token OAuth2.
Este token se puede consultar en la parte superior de la página principal, dentro del apartado de APIS:
Estas APIS son de carácter genérico y están pensadas para que los usuarios de la plataforma desarrollen apps externas.
A modo explicativo de ejemplo, realizaremos una consulta de tipo JOIN con la plataforma. Para ello, haciendo click en el apartado APIS anteriormente descrito, veremos un pop-up similar al siguiente:
El cual incluye el propio token OAuth2 que será necesario utilizar (no confundir con el token del apartado de APIs) y una serie de APIs predefinidas para poder trabajar con ellas.
En nuestro caso, y para autenticarnos mediante el token OAuth2 contra la plataforma, en el apartado de APIS, seleccionamos “Control Panel”, el cual nos redirigirá al Swagger básico creado para las operaciones de este módulo:
De igual forma que en el caso anterior, accedemos dentro del bloque login-management-controller, y allí encontramos varias llamadas de tipo POST y GET para realizar diferentes operaciones, como por ejemplo, la autenticación contra la plataforma ( /api-ops/login ). El funcionamiento es similar al de apartados anteriores, pero en este caso, el token lo coge automáticamente de la plataforma, ya que es único. La respuesta obtenida es algo de este tipo, devolviéndonos una sessionkey que podremos utilizar en el resto de llamadas (hay que tener en cuenta de que la sesión puede caducar pasado cierto tiempo, y tendremos que renovarla):
Utilizando ese token de acceso, podemos realizar multitud de operaciones e invocaciones a la plataforma.