BÁSICO · 8 MÓDULOS · 64 LECCIONES
Diseño de APIs e integración
Diseña APIs que otros sistemas puedan usar sin sorpresas: recursos claros, errores útiles, paginación bien hecha y cambios que no rompen a quien ya las consume.
- Es para ti si
- Construyes endpoints backend y quieres dejar de improvisar contratos que se rompen al primer cambio.
- Al terminar
- Sabrás versionar una API, hacer peticiones idempotentes, documentarla con OpenAPI y decidir cuándo conviene gRPC o GraphQL.
- Necesitas
- Python básico, HTTP básico y haber construido al menos un endpoint, aunque sea simple.

Temario
01Qué es una API y qué es un buen diseño
- Presentación del módulo: la API de Mercado como un contrato público
- Una API es un contrato
- Orientada al consumidor, no a la tabla de la BD
- Recursos, no acciones
- Consistencia y el principio de la menor sorpresa
- El costo de romper el contrato
- La API de Mercado: buenos y malos ejemplos
- Mini-proyecto: rediseña un endpoint que filtra el esquema
03Diseño de peticiones y respuestas
- Presentación del módulo: diseñar lo que entra y lo que sale
- Paginación: por qué cursor gana a offset
- Filtrado y ordenamiento
- Selección de campos: sparse fieldsets
- Envelopes vs recurso pelón
- Fechas y horas: ISO 8601 en UTC
- Dinero: centavos enteros, nunca float
- Proyecto: diseña las respuestas de `GET /products` de Mercado
04Errores y códigos de estado
- Presentación del módulo: el error es parte del contrato
- Por qué un contrato de errores
- `problem+json`: el formato estándar (RFC 9457)
- 400 vs 422 vs 409: qué código para qué falla
- Los otros códigos: 401, 403, 404, 410, 429
- Errores accionables: qué campo y cómo arreglarlo
- Idempotencia de POST con Idempotency-Key
- Proyecto: el contrato de errores de Mercado
05Versionado y evolución
06Contratos, schemas y documentación
- Presentación del módulo: el contrato que se puede leer sin ti
- Por qué un contrato explícito
- OpenAPI: describir la API en un archivo
- JSON Schema: la forma del dato
- Contract-first: el contrato antes que el código
- Validar el request contra el schema
- La documentación como parte del contrato
- Proyecto: el OpenAPI + JSON Schema de un endpoint de Mercado
07Más allá de REST — gRPC y GraphQL
08Proyecto — diseña la API de Catalog de Mercado
- Presentación del módulo: la API como contrato, en un solo diseño
- Recursos y endpoints: la superficie completa
- Paginación por cursor y filtrado
- El contrato de errores y la idempotencia
- El JSON Schema y la doc como contrato
- El plan de versionado y un cambio que no rompe
- La decisión de protocolo por límite
- Proyecto: diseña y ejecuta la API de Catalog+Orders
Reseñas
Lo que dicen los estudiantes
Estas reseñas son de estudiantes inscritos que completaron al menos el 50% del curso. Moderamos las reseñas solo por motivos de contenido (spam, lenguaje ofensivo, datos personales), nunca por ser críticas o negativas.
Aún no hay reseñas aprobadas.
¡Sé el primero en compartir tu experiencia!