El Nodo de Interoperabilidad permite a los organismos del Estado proveer sus propias APIs y Servicios Web de la manera más simple y menos intrusiva posible, para que puedan integrarse a la Red de Interoperabilidad sin que esto signifique modificar sus aplicaciones.
El Nodo de interoperabilidad funciona como un gateway seguro que solo redirige los llamados de organismos ya autorizados a los servicios web finales sin requerir cambios en ellos manteniendo formato, cabeceras, métodos de seguridad y todo lo que ya estaba en funcionamiento en dicho servicio.
En el archivo config.json del Nodo se debe agregar un bloque en la sección “proveedor” donde se definen como se comportará la publicación del servicio.
Si la sección “proveedor” no existe, la debe crear.
"proveedor": [
{
"nombre": "NombreDelServicio",
"origen": {
"tipo": "WEB_SERVICE",
"rutaLocal": "http://localhost/miservicio"
},
"rutaExterna": "/apis/miServicio",
"tps": 20
}
]nombre: Define cómo se llamará el servicio dentro de la red de interoperabilidad. Este nombre no se debe repetir en el catálogo de servicios.
origen:
tipo: Define que tipo de origen de datos es. WEB_SERVICE sirve tanto para apis como web service soap
ruta local: Esta es la ruta del servicio real. Se debe cuidar que desde la máquina donde está el Nodo sea posible llamar a esta ruta.
ruta externa: Este es parte de la ruta como se expondrá el servicio hacia internet
tps: Cantidad de transacciones por segundo que el Nodo permitirá a los consumidores.
Una vez que se configura el servicio en el Nodo es necesario agregarlo al catálogo de Servicios. Este paso lo realiza el equipo de interoperabilidad de Gobierno Digital pero para realizar es necesario enviar los siguientes datos para poder agregarlo:
Nombre del servicio: Es el nombre del servicio tal como fue configurado en el Nodo.
Descripción: Descripción del servicio. Esta descripción aparecerá en el catálogo de servicios para que los futuros consumidores entiendan la naturaleza del servicio web.
URL del servicio: Esta ruta se compone del DNS del servidor, puerto del Nodo y la ruta externa tal como fue configurada en el Nodo.
Ej. https://api.ministerio.gob.cl:8449/apis/miServicio
Con estos datos Gobierno Digital ya puede agregar el servicio al catálogo.
Si existe una API con parámetros en la ruta y se requiere proveerla a través del Nodo de PISEE se deben tomar algunas consideraciones:
Ejemplo de API:
http://ip_o_dns/codigos/2/{codigo}
El Nodo del proveedor va solo con la ruta que es fija, tanto en la ruta externa como en la ruta local:
{
"nombre": "gescod_CodigosUnicosTerritoriales",
"rutaExterna": "/gescod_codigosunicosterritoriales",
"tps": 40,
"origen": {
"tipo": "WEB_SERVICE",
"rutaLocal": "http://ip_o_dns/codigos/2"
}
}Y en el consumidor se configura con el parámetro que espera:
{
"nombre": "gescod_CodigosUnicosTerritoriales",
"rutaLocal": "/CodigosUnicosTerritoriales/{codigo:.*}"
}Por lo tanto el usuario del Nodo consumidor debe hacer el llamado con el o los parámetros correspondientes:
http://localhost:8085/CodigosUnicosTerritoriales/11