OpenAPI sin dolor
Formación de 142 minutos para escribir especificaciones OpenAPI limpias, reutilizables y fáciles de mantener. La guía que Daniel Alfocea habría querido tener al empezar a escribir APIs.
Con Daniel Alfocea
- de vídeo
- 142 min
- vídeos
- 21
- nivel
- principiante
Para quién es
Desarrolladores y arquitectos que quieren dejar de sufrir con la documentación de APIs, y equipos de frontend y backend que necesitan un contrato claro. Sin conocimientos previos de OpenAPI.
Sobre la formación
Escribir OpenAPI sin pelearte con él
142 minutos de vídeo para escribir especificaciones OpenAPI claras, reutilizables y fáciles de mantener.
Casi nadie odia documentar APIs. Lo que odia es hacerlo sin que nadie le haya enseñado cómo.
Y se nota:
- Especificaciones caóticas.
- Endpoints duplicados.
- Esquemas que no se parecen entre sí.
- Discusiones eternas entre frontend y backend.
Todo eso acaba igual: errores en producción y tiempo perdido.
El primer paso para arreglarlo es tener un buen OpenAPI.
Quién te lo cuenta
Soy Daniel Alfocea (o cr0hn, como prefieras). Llevo veinte años entre desarrollo y seguridad.
Pasé 5 años como ingeniero líder en uno de los productos de 42Crunch, una empresa del Reino Unido especializada en seguridad de APIs.
Hice esta formación por un solo motivo: es la guía que me habría gustado tener cuando empecé a escribir APIs.
Lo que te llevas
Primero, qué es una especificación y para qué la necesitas, antes de escribir una línea.
Luego cómo definir los datos bien: el cuerpo de la petición, los tipos de datos y las estructuras que más vas a usar.
Aprendes a no repetirte. Componentes reutilizables, herencia entre esquemas y organización con tags, para que la especificación no crezca a base de copiar y pegar.
Un módulo va de validar: la validación de datos como tu primera línea de defensa, para frenar lo malo antes de que llegue al backend.
También los ejemplos, las extensiones para lo que la especificación no cubre y un puñado de trucos que ahorran tiempo y errores.
Y cierras con generadores. Cómo sacar la especificación de FastAPI y de Spring Boot sin ensuciarla, qué herramientas de código abierto generan una por ti y una herramienta todo en uno, Capture.
Quiero escribir mejores especificaciones
Para quién es
Es para ti si:
- Eres desarrollador o arquitecto y quieres dejar de sufrir con la documentación.
- Te toca mantener APIs heredadas y no sabes por dónde empezar.
- Trabajas en un equipo donde frontend y backend no se entienden.
- Quieres usar OpenAPI para mejorar la calidad, la seguridad y la comunicación.
Qué cuesta
99 €, un pago, y la formación es tuya. Si la actualizo, la versión nueva la tienes sin volver a pagar.
No es un curso de seguridad ni de diseño de APIs en general. Es sobre escribir bien la especificación. Si ya la escribes con esquemas reutilizables, validaciones y ejemplos, el módulo 2 te dirá poco nuevo y irás directo a los generadores y al bonus.
Un abrazo,
Dani
P. D. Si dudas, mira primero la lección abierta. En menos de 7 minutos sabes si es para ti.
Temario
Son 142 minutos de vídeo en 21 lecciones, más un examen y las transparencias, repartidos en 6 módulos. Las marcadas «Muestra» se ven sin entrar.
01¿De qué va esto? 1 lección · unos 7 min
- Qué es una especificación y para qué narices la necesito 6:37
02Escribiendo OpenAPIs Sin Dolor 14 lecciones · unos 100 min
- Definición de datos y demás yerbas
- Request Body: cómo definir correctamente los datos de entrada
- Tipos de datos: estructuras comunes y cómo usarlas en OpenAPI
- Componentes (I): definición y reutilización básica
- Componentes (II): enlaces entre operaciones con Links
- Componentes (III): gestión de eventos con Callbacks
- Componentes (IV): organización de la documentación con Tags
- Validación de datos: tu primera línea de defensa
- Herencia en OpenAPI: reutiliza y extiende definiciones sin repetir
- Extensiones en OpenAPI: añade lo que la especificación no cubre
- Ejemplos en OpenAPI: muestra claramente lo que esperas recibir y enviar
- Trucos útiles en OpenAPI: atajos que te ahorran tiempo y errores
- OpenAPI: cosas útiles que no sabías que podías hacer
- Buenas y malas prácticas en OpenAPI: lo que deberías (y no deberías) hacer
03Auto-Generadores de OpenAPIs y cómo ahorrarte parte del trabajo 5 lecciones · unos 24 min
- Empezar desde 0 es muy tedioso
- Usa bien los frameworks y FastAPI
- A Spring Boot también hay que darle cariño
- Generando automáticamente con herramientas OpenSource
- El todo en uno: Capture
04Checkpoint final 1 lección
- Examen de certificación
05Transparencias 1 lección
- Transparencias del curso
06BONUS 1 lección · unos 10 min
- Bonus 1 - Los 5 errores más comunes al escribir OpenAPIs (y cómo evitarlos)
Lecciones de muestra
Míralas antes de pagar.
-
Qué es una especificación y para qué narices la necesito6:37
Quién lo imparte
Daniel Alfocea
Veinte años en desarrollo y seguridad, y autor de herramientas como GoLismero, Plecost y Dockerscan.
Dudas
Necesito saber OpenAPI antes de empezar
No. Se empieza desde cero y se explican los conceptos básicos antes de pasar a ejemplos reales.
Solo necesitas saber qué es una API y ganas de hacer las cosas bien.
Se ve código o es solo teoría
Me sirve si ya uso Swagger
Vale para mi lenguaje o framework
Sí. OpenAPI no depende del lenguaje, así que lo que aprendes te sirve igual en Python, Java, Go o Node.
Hay un módulo con FastAPI y Spring Boot para ver cómo generan la especificación por ti, y cómo no estropearla.
Hay certificado
142 minutos valen 99 €
Si te ahorran una sola discusión larga entre frontend y backend sobre qué devuelve un endpoint, ya van camino de amortizarse.
Y si no lo ves claro, mira primero la lección abierta. Son menos de 7 minutos y no pagas nada por verla.
Para quién esDesarrolladores y arquitectos que quieren dejar de sufrir con la documentación de APIs, y equipos de frontend y backend que necesitan un contrato claro. Sin conocimientos previos de OpenAPI.