Diferencia entre revisiones de «SIU-Guarani/Version3.20.0/API REST GUARANI»
m |
m |
||
Línea 33: | Línea 33: | ||
password = <pass_usuario_externo> | password = <pass_usuario_externo> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | '''<usuario_externo>''': Usuario para consumir la API REST SIU-Guaraní, ej: | + | '''<usuario_externo>''': Usuario para consumir la API REST SIU-Guaraní, ej: sq para un usuario de Sanaviron-Quilmes que quiera consumir la API REST SIU-Guaraní. |
'''<pass_usuario_externo>''': Password del usuario <usuario_externo>. | '''<pass_usuario_externo>''': Password del usuario <usuario_externo>. | ||
Línea 39: | Línea 39: | ||
<syntaxhighlight lang="bash" enclose="div" highlight="4"> | <syntaxhighlight lang="bash" enclose="div" highlight="4"> | ||
− | |||
[admin] | [admin] | ||
password = "123456789*-a" | password = "123456789*-a" | ||
Línea 62: | Línea 61: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | Así mismo, se deberá crear el archivo <code><path_gestion>/ | + | Así mismo, se deberá crear el archivo <code><path_gestion>/instalacion/i__desarrollo/p__guarani/rest/recursos_usuarios.php</code> a partir de su respectivo template <code><path_gestion>/php/rest/recursos_usuarios_template.php</code> (el mismo es un archivo autodocumentado).<br /> |
Y se deben agregar los usuarios que se configuraron en el paso anterior (<code><path_gestion>/instalacion/i__desarrollo/p__guarani/rest/servidor_usuarios.ini</code>). | Y se deben agregar los usuarios que se configuraron en el paso anterior (<code><path_gestion>/instalacion/i__desarrollo/p__guarani/rest/servidor_usuarios.ini</code>). | ||
− | [[ | + | <syntaxhighlight lang="bash" enclose="div" highlight="4"> |
+ | <?php | ||
+ | |||
+ | /* | ||
+ | * Agregar los usuarios correspondientes | ||
+ | * que coincidan con los configurados en el archivo "instalacion/i__desarrollo/p__guarani/rest/servidor_usuarios.ini" | ||
+ | */ | ||
+ | $usuarios_admin = ['admin']; | ||
+ | $usuarios_tehuelche = ['tehuelche']; | ||
+ | $usuarios_sq = ['sq']; | ||
+ | $usuarios_3w = ['3w']; | ||
+ | $usuarios_sidcer = ['sidcer']; | ||
+ | $usuarios_verificador = ['verificador']; | ||
+ | $usuarios_preinscriptos = ['preinscriptos']; | ||
+ | |||
+ | ............... | ||
+ | </syntaxhighlight> | ||
También será necesario configurar la API para poder comunicar los módulos de gestión y autogestión. Para realizar esta configuración consultar [[SIU-Guarani/version3.20.0/interfaces/gestion-3w-rest| este link]].<br> | También será necesario configurar la API para poder comunicar los módulos de gestión y autogestión. Para realizar esta configuración consultar [[SIU-Guarani/version3.20.0/interfaces/gestion-3w-rest| este link]].<br> |
Revisión del 11:05 20 oct 2021
Sumario
API-REST Guaraní
La API REST de SIU-Guaraní engloba un conjunto de servicios que utiliza el módulo para comunicarse (transferir o consumir datos) con otros sistemas.
Durante el proceso de instalación y configuración del módulo será necesario configurar qué usuarios se conectarán con el módulo a través de la API
NOTA: A partir de la versión 3.20.0 la API REST pasa a versionarse, y sera accedida a través de la URL http://<url_gestion>/rest/v1/.
Configuración de la API-REST
La configuración de la API es uno de los pasos detallados en el proceso de instalación del sistema. Más precisamente ocupa el paso n° 12 del mismo. Link a los pasos del proceso de instalación del sistemas.
Configuración Técnica de la API
Se debe configurar el archivo <path_gestion>/instalacion/i__desarrollo/p__guarani/rest/servidor.ini
para la definición de las rutas de las versiones de la API REST:
autenticacion = digest
; Configuración de paths para las versiones de la api
[v1]
path_api=<path_gestion>/php/rest/v1
path_api_pers=<path_gestion>/personalizacion/php/rest/v1
Se debe configurar el archivo <path_gestion>/instalacion/i__desarrollo/p__guarani/rest/servidor_usuarios.ini
para la definición de usuarios que consumirán la API REST SIU-Guaraní.
Se recomienda tener diferentes usuarios para los sistemas Tehuelche, Sanaviron-Quilmes, 3W y SICer.
El formato es:
password = <pass_usuario_externo>
<usuario_externo>: Usuario para consumir la API REST SIU-Guaraní, ej: sq para un usuario de Sanaviron-Quilmes que quiera consumir la API REST SIU-Guaraní. <pass_usuario_externo>: Password del usuario <usuario_externo>.
Por ejemplo:
password = "123456789*-a"
[tehuelche]
password = "123456789*-a"
[sq]
password = "123456789*-a"
[3w]
password = "123456789*-a"
[sidcer]
password = "123456789*-a"
[verificador]
password = "123456789*-a"
[preinscriptos]
password = "123456789*-a"
Así mismo, se deberá crear el archivo <path_gestion>/instalacion/i__desarrollo/p__guarani/rest/recursos_usuarios.php
a partir de su respectivo template <path_gestion>/php/rest/recursos_usuarios_template.php
(el mismo es un archivo autodocumentado).
Y se deben agregar los usuarios que se configuraron en el paso anterior (<path_gestion>/instalacion/i__desarrollo/p__guarani/rest/servidor_usuarios.ini
).
/*
* Agregar los usuarios correspondientes
* que coincidan con los configurados en el archivo "instalacion/i__desarrollo/p__guarani/rest/servidor_usuarios.ini"
*/
$usuarios_admin = ['admin'];
$usuarios_tehuelche = ['tehuelche'];
$usuarios_sq = ['sq'];
$usuarios_3w = ['3w'];
$usuarios_sidcer = ['sidcer'];
$usuarios_verificador = ['verificador'];
$usuarios_preinscriptos = ['preinscriptos'];
...............
También será necesario configurar la API para poder comunicar los módulos de gestión y autogestión. Para realizar esta configuración consultar este link.
Servicios contenidos en la API
El listado completo de los webservices de la API pueden verlos en este link: https://documentacion.siu.edu.ar/apis/?spec=guarani_v1.
Personalización de la API
¿Necesitás crear nuevos servicios REST? Mira esta documentación para saber cómo hacer esta personalización.