[XWS-030] OpenAPI - API First

Este curso abarca conceptos clave de la filosofía REST, como URIs, HTTP y HATEOAS, y profundiza en el enfoque API First. Se exploran herramientas como Swagger y Prism para definir, validar y probar APIs con especificaciones OpenAPI. También cubre la documentación, el ciclo de vida y despliegue de APIs.

Duración:                     24 horas

Perfil:                           Intermedio

Dirigido a

Esta acción formativa está destinada a programadores y analistas interesados en aprender sobre el enfoque API First, la especificación OpenAPI y las mejores prácticas para diseñar, implementar y probar APIs eficientes y escalables.

Requisitos previos 

Los alumnos necesitarán tener experiencia en los servicios REST previamente para poder comprender la materia del curso con éxito.

Objetivos

• Comprender los principios de REST y API First.
• Aprender a definir y documentar APIs.
• Utilizar herramientas como Swagger y Prism.
• Implementar y probar APIs.
• Generar y gestionar la documentación de APIs y desplegar servicios.

Contenido

1. Introducción a la filosofía REST

   1. Definición de REST
   2. Uso correcto de URIs y el protocolo HTTP
   3. Conceptos de Hipermedia y servicios CRUD
   4. Principio HATEOAS en el diseño de APIs

2. Enfoque API First

   1. Definición y principios del enfoque API First
   2. Ventajas de adoptar API First en el desarrollo de software
   3. La importancia de la definición y especificación de la API desde el inicio

3. Definición de OpenAPI

   1. Qué es la especificación OpenAPI
   2. Herramientas de Swagger: Swagger Editor, Swagger UI, Codegen y SwaggerHub
4. Validación de la definición
   
   1. Uso de linters
   2. Aplicación de reglas de validación con Spectral

5. Servidores Mock
   

   1. Concepto de servidor mock y su utilidad en el desarrollo de APIs
   2. Configuración y uso de Prism para generar servidores mock basados en la especificación OpenAPI

6. Implementación y pruebas de APIs

   1. Implementación de una API según la especificación OpenAPI
   2. Herramientas para pruebas de APIs: Postman, SoapUI
   3. Librerías para pruebas con código: RestAssured, Mocha

7. Generación de documentación
   

   1. Cómo generar documentación automática a partir de la especificación OpenAPI
   2. Uso de herramientas como Rapidoc y Redoc para visualizar documentación
8. Despliegue
   1. Gestión del ciclo de vida de la API
   2. Publicación en portales de APIs

Documentación Recomendada

Designing APIs with Swagger and OpenAPI
Joshua S. Ponelat and Lukas L. Rosenstock
August 2019 | 400 pages
ISBN 9781617296284

https://www.manning.com/books/designing-apis-with-swagger-and-openapi?query=swagger