alice-and-bob

APIs

Spanish

Qué es una especificación y para qué narices la necesito

¿De qué va esto?

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

Escribiendo OpenAPIs Sin Dolor

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

Auto-Generadores de OpenAPIs y cómo ahorrarte parte del trabajo

¿listo para el certificado?

Checkpoint final

Transparencias del curso

Transparencias

Bonus 1 - Los 5 errores más comunes al escribir OpenAPIs (y cómo evitarlos)

BONUS

La mayoría de los equipos odian documentar APIs.No porque no quieran hacerlo, sino porque nadie les ha enseñado cómo hacerlo bien.El resultado: <ul><li>Especificaciones caóticas, </li><li>Endpoints duplicados, </li><li>Esquemas inconsistentes </li><li>Discusiones eternas entre frontend y backend.</li></ul>Y todo eso termina en lo mismo: <h2 id="a3570170-6f9e-40de-b432-680715473c12" data-toc-id="a3570170-6f9e-40de-b432-680715473c12" style="font-size: 24px; font-weight: 600; line-height: 1.2;">Errores en producción y pérdida de tiempo.</h2>El autor es Daniel García (o cr0hn, como le gusta que le llamen).Después de 5 años siendo el ingeniero líder en uno de los productos 42Crunch, una empresa de U.K. especializada en seguridad de APIs, decidió hacer este curso.Según él mismo dice.“Hice este curso por un solo motivo:Es la guía que, ojalá, hubiera tenido cuando empecé a escribir APIs.”Te enseña OpenAPI paso a paso, sin dolor, sin confusión y sin perder tiempo.El objetivo es que aprendas a escribir especificaciones limpias, útiles y mantenibles, incluso si tu API ya está en marcha.Cuando tienes un buen OpenAPI puedes:<ul><li>Automatizar documentación, </li><li>Generar clientes, </li><li>Generar tests </li><li>Generar mocks, </li><li>Usarla como contrato real entre equipos.</li></ul><h3 id="3312127e-6322-41a3-8da2-380d7e588673" data-toc-id="3312127e-6322-41a3-8da2-380d7e588673" style="font-size: 20px; font-weight: 600; line-height: 1.2;">Pero el primer paso empieza por un buen OpenAPI.</h3><h2 id="379f34ab-27f7-4426-a157-9e2fc7bb4a98" data-toc-id="379f34ab-27f7-4426-a157-9e2fc7bb4a98" style="font-size: 24px; font-weight: 600; line-height: 1.2;">Qué aprenderás</h2>✅ A escribir especificaciones OpenAPI claras y consistentes.✅ A evitar errores comunes con arrays, ejemplos múltiples y validaciones.✅ A crear esquemas reutilizables que ahorran tiempo y evitan duplicaciones.✅ A validar peticiones y respuestas antes de llegar al backend.✅ A versionar y marcar endpoints obsoletos sin romper integraciones.✅ A generar documentación, tests y clientes de forma automática.✅ A mantener tus specs limpias a medida que crece tu API.<h2 id="44107675-1368-4d6c-9526-c7d64d84e707" data-toc-id="44107675-1368-4d6c-9526-c7d64d84e707" style="font-size: 24px; font-weight: 600; line-height: 1.2;">Ideal para ti si…</h2>✔️ Eres desarrollador o arquitecto que quiere dejar de sufrir con la documentación.✔️ Te toca mantener APIs heredadas y no sabes por dónde empezar.✔️ Trabajas en equipos donde frontend y backend no se entienden.✔️ Quieres aplicar OpenAPI para mejorar la calidad, la seguridad y la comunicación.<h2 id="e434f8b3-f5c8-4447-94a2-bf12d2900fba" data-toc-id="e434f8b3-f5c8-4447-94a2-bf12d2900fba" style="font-size: 24px; font-weight: 600; line-height: 1.2;">Preguntas frecuentes (FAQ)</h2><h3 id="b50d9204-22e8-47fb-b776-6605db77d860" data-toc-id="b50d9204-22e8-47fb-b776-6605db77d860" style="font-size: 20px; font-weight: 600; line-height: 1.2;">¿Necesito saber OpenAPI antes de hacer el curso?</h3>No. Empezamos desde cero, explicando los conceptos básicos antes de entrar en ejemplos reales.Solo necesitas saber qué es una API y tener curiosidad por hacer las cosas bien.<h3 id="2a1c5bd7-7a71-48e5-b0f8-2a4cbff61aee" data-toc-id="2a1c5bd7-7a71-48e5-b0f8-2a4cbff61aee" style="font-size: 20px; font-weight: 600; line-height: 1.2;">¿Se ve código o solo teoría?</h3>Se ve práctica real. Verás cómo se escriben especificaciones.<h3 id="929d2221-5004-4551-aa44-4c07e7701beb" data-toc-id="929d2221-5004-4551-aa44-4c07e7701beb" style="font-size: 20px; font-weight: 600; line-height: 1.2;">¿Sirve si ya uso Swagger?</h3>Sí. Swagger es una herramienta que trabaja sobre OpenAPI. Si ya lo usas, entenderás mejor qué hace por debajo y cómo aprovecharlo al máximo.<h3 id="5d941d33-fdac-42c4-9392-7c32ab777b78" data-toc-id="5d941d33-fdac-42c4-9392-7c32ab777b78" style="font-size: 20px; font-weight: 600; line-height: 1.2;">¿Puedo aplicarlo a cualquier lenguaje o framework?</h3>Sí. OpenAPI es agnóstico al lenguaje. Lo que aprendas aquí te servirá igual si trabajas con Python, Java, Go, Node o cualquier otro stack.<h3 id="42d5ae1e-dbce-4702-92c0-c899fd39c233" data-toc-id="42d5ae1e-dbce-4702-92c0-c899fd39c233" style="font-size: 20px; font-weight: 600; line-height: 1.2;">¿Qué gano realmente con este curso?</h3>Orden, claridad y tiempo. Dejar de perder horas discutiendo con otros equipos y empezar a tener specs que realmente reflejan cómo funciona tu API.<h3 id="e717b2b8-64c3-48eb-80a1-7ea71ff162ea" data-toc-id="e717b2b8-64c3-48eb-80a1-7ea71ff162ea" style="font-size: 20px; font-weight: 600; line-height: 1.2;">¿Incluye algún certificado?</h3>Sí. Al completar el curso recibirás un certificado de finalización emitido por Alice &amp; Bob.

Todo lo que necesitas para escribir especificaciones OpenAPI claras y detalladas explicado de forma sencilla

103 - OpenAPI sin dolor: La guía que ojalá hubiera tenido cuando empecé a escribir APIs

Course content

103 - OpenAPI sin dolor: La guía que ojalá hubiera tenido cuando empecé a escribir APIs

Dani Garcia

This course includes

Includes