Bonus ZPM y Open API para el Concurso con REST API

Solapas principales

¡Hola desarrolladores!

Como sabéis, en el segundo concurso, introdujimos unos bonus tecnológicos.  Aquí podéis ver la publicación >>

Se puede ver qué aplicaciones han obtenido bonus en el menú de Bonus Tecnológicos:

Y aquí quiero compartir con todos las aplicaciones que obtuvieron los bonus. ¡Veámoslas!

ZPM Module Bonus

Para obtener el bonus ZPM, los concursantes deberían haber publicado un módulo en el Community Package Manager.

Estos son los proyectos que lo hicieron:

Proyecto

ZPM Command

   Production Manager    install production-manager
   JSON-Filter    install json-filter
   iris-history-monitor    install iris-history-monitor
   simple-spellchecker    install simple-spellchecker
   isc-apptools-admin    install isc-apptools-admin

ZPM ofrece una forma muy práctica de instalar la aplicación, es decir, todos los módulos anteriores se pueden probar con los siguientes 3 comandos:

1. Launch IRIS:

$ docker run --name my-iris -d --publish 9091:51773 --publish 9092:52773 intersystemsdc/irishealth-community:2020.2.0.196.0-zpm

2. Open IRIS terminal and launch ZPM:

$ docker exec -it my-iris iris session IRIS

USER>zpm

zpm:USER>

3.  Install a module: 

zpm:USER>install module-name

Así que todos estos proyectos obtienen un punto extra por la implementación de ZPM. ¡Enhorabuena!

Open API spec

Para obtener el bonus de Open API spec, los concursantes deben haber introducido el / _spec endpoint en su API, que expone la descripción de la API ABIERTA de su API REST.

Estos son los proyectos que lo hicieron:

Proyecto

Endpoint

   Production Manager    /production/_spec
   JSON-Filter    /jsonfilterrest/_spec
   REST for Tasks on my Status Report    /crud/task/_spec

Así que esos proyectos obtienen un punto extra por la Open API Spec! ¡Enhorabuena!

La especificación Open API se puede leer fácilmente con Postman, Swagger UI o IRIS, si se instala el módulo swagger-ui:

zpm:USER>install swagger-ui

Y si abres:

localhost:52773/swagger-ui/index.html 

y pones la URL de la especificación en ella, y obtienes la siguiente página UI, como esta:

swagger-ui

Spec-first approach

Para obtener el bonus de enfoque de especificación primero, los concursantes deben presentar una aplicación donde REST API en el lado de IRIS se genera a partir de la especificación OpenAPI preparada de antemano.

¡Nadie hizo esto!

Sin embargo, es un gran enfoque para desarrollar APIs REST. ¡Espero que lo uses en tu desarrollo!

¡Buena suerte en la votación!