[[PageOutline(2-5,Índice)]]

= Uso de swager para probar la API REST de OpenGnsys =

La API REST de OpenGnsys está documentada con swager que crea automáticamente un listado de ejemplos de  la funciones que nos permiten utilizarlas y nos muestra la orden que debemos usar con curl.

Antes de usar una función hemos de autenticarnos. Para ello vamos a la función/url de login.

En el ejemplo ponemos el usuario por defecto de OpenGnsys.

[[Image(APIREST-000.png)]]

Al pulsar “Try it” nos muestra el comando que ha utilizado y nos devuelve el token para autenticar las comunicaciones que hagamos con el servidor:

[[Image(APIREST-002.png)]]

En la parte de arriba de la página pulsaremos “Authorize”, nos aparecerá un formulario donde incluiremos la API KEY que nos ha dado el paso anterior.


[[Image(APIREST-004.png)]]

A partir de ahora todas las consultas contendrán el token.

Como ejemplo vamos a consultar los repositorios que tiene configurado nuestra unidad organizativa. 

[[Image(APIREST-006.png)]]

En el único campo que pide pondremos el identificador de nuestra unidad organizativa. Al dar a “Try it out” devolverá los repositorios que tenemos dados de alta.


[[Image(APIREST-008.png)]]





Observamos que en el apartado “Curl” el comando que envía incluye el token de autenticación.