Comunicación fiableentre servicios

Diseñar APIs que otros entienden y mantienen: REST, autenticación, contratos OpenAPI, versionado y, cuando conviene, GraphQL o gRPC. Crearlas, probarlas e inspeccionarlas como en un equipo real.

Empezar

Acceso al curso completo, ejercicios y material de entrevista.

# Pedir una colección con filtro y paginación
GET /v1/pedidos?estado=enviado&limit=2
Authorization: Bearer eyJhbGci...
Accept: application/json

→200 OK # Cache-Control: private, max-age=30

→{ "data": [{ "id": 481, "estado": "enviado" }, ...],

→ "next": "/v1/pedidos?cursor=eyJpZCI6NDc5fQ" }

⧗Cursor, no offset: estable aunque cambien los datos

# Crear un recurso: validación y código correcto
POST /v1/pedidos
Idempotency-Key: a3f9c1...   # reintentos seguros

{ "producto_id": 12, "cantidad": 0 }

→422 Unprocessable Entity

→{ "error": "validation_failed",

→ "detail": [{ "field": "cantidad", "msg": "debe ser > 0" }] }

⧗Error consistente y útil, sin filtrar nada interno

# El contrato primero: una sola fuente de verdad
paths:
  /pedidos/{id}:
    get:
      summary: Obtener un pedido
      responses:
        '200': { $ref: '#/components/schemas/Pedido' }
        '404': { description: No encontrado }

→$ openapi-generator generate ...

→✓ cliente TypeScript generado

→✓ Swagger UI publicado en /docs

⧗Tipos, docs y mocks salen del mismo contrato

Orientado a entrevistas

No solo aprendes APIs. Te preparas para que te contraten.

Banco orientado a la entrevista técnica: diseñar una API sobre la marcha, elegir el código de estado, versionar sin romper y justificar REST frente a GraphQL.

Preguntas

Preguntas reales de entrevistas técnicas.

Errores comunes

Lo que delata a un junior frente al entrevistador.

Retos de debug

Endpoints mal diseñados que hay que corregir.

Qué vas a aprender

Del 200 OK a diseñar una API que cualquiera entiende

HTTP a fondo

Métodos, códigos de estado, cabeceras, idempotencia, CORS y HTTP/2-3.

Diseño REST que se usa solo

Recursos, errores consistentes, filtrado, paginación por cursor y operaciones en lote.

Autenticación y seguridad de APIs

API keys, JWT, OAuth 2.0 y alcances; el OWASP API Top 10 y la exposición de datos.

Contratos, versionado y fiabilidad

OpenAPI contract-first, versionar sin romper, caché HTTP, rate limiting e idempotencia.

REST, GraphQL, gRPC y eventos

Cada estilo y cuándo encaja: webhooks, tiempo real, AsyncAPI y RPC binario.

Crear, probar e inspeccionar APIs

Construir en Express, FastAPI, DRF y Spring; curl, Postman, proxies y contract testing.