En este artículo, pretendo demostrar un par de métodos para añadir fácilmente validación a las APIs REST en InterSystems IRIS Data Platform. Creo que un enfoque specification-first es una idea excelente para el desarrollo de APIs. IRIS ya dispone de funcionalidades para generar un esqueleto de implementación a partir de una especificación y publicar esa especificación para desarrolladores externos (usadlo junto con iris-web-swagger-ui para obtener los mejores resultados). Lo único importante que aún no está implementado en la plataforma es el validador de solicitudes. ¡Vamos a solucionarlo!
#Swagger
Swagger es una estructura de código abierto que se utiliza para diseñar, crear, documentar y consumir API RESTful. Proporciona una interfaz fácil de usar y herramientas que facilitan a los desarrolladores la comprensión y la interacción con las API sin necesidad de profundizar en el código. Swagger utiliza un formato estándar denominado OpenAPI Specification para describir la estructura y el comportamiento de las API. Se utiliza ampliamente para generar documentación de API, probar endpoints e incluso generar automáticamente código de cliente y servidor.