Colección 02

API contract testing y sistemas distribuidos

Contratos, idempotencia y evolución sin romper consumidores.

4 artículos · ~29 min de lectura ·3 repos de soporte
Pilar · empezá acá Intermedio–Avanzado

Contratos de API en una plataforma de transferencias: qué garantizan y qué no

Diseñá contratos de API verificables para transferencias: diferencias entre especificación, contrato, prueba y monitoreo, con OpenAPI, Pact y AsyncAPI.

Leer el pilar 11 min

Satélites · profundizan el pilar, en orden

  1. 02

    Consumer-Driven Contract Testing: cuándo vale la pena y cuándo alcanza un OpenAPI gobernado

    Guía de decisión sobre CDCT con Pact: qué verifica realmente, sus costos de gobernanza y cuándo un OpenAPI versionado bien gobernado es suficiente.

    Intermedio–Avanzado 5 min contract-testingpactconsumer-driven
  2. 03

    Idempotencia, dinero y eventos: cómo hacer que una transferencia ocurra una sola vez

    Diseñá una transferencia segura de reintentar: Idempotency-Key, códigos 409/422, dinero como decimal, estados y deduplicación de eventos con eventId.

    Avanzado 8 min idempotenciaapiseventos
  3. 04

    Evolución de contratos y cambios rompientes en APIs y eventos

    Cómo evolucionar contratos de API y eventos sin romper consumidores: aditivo vs. rompiente, compatibilidad, versionado, deprecación y convivencia.

    Intermedio–Avanzado 5 min versionado-apiscompatibilidadcontract-testing

Código que implementa esta colección

nexo-transfer-api API de transferencias: Java 21, Spring Boot, Cucumber BDD y REST-assured. Idempotency-Key, autorización por titularidad y BigDecimal.
visual-and-contract-testing Contract testing con Pact (consumidor y proveedor reales) y regresión visual con Playwright.
api-testing-framework-restful-booker Framework de testing de API con Playwright, TypeScript y Zod: contratos por schema, builders de datos y setup por API.
Continúa en la serie avanzada Event-driven y contratos asíncronos

Qué cambia cuando las partes se comunican de forma asíncrona: outbox, consumidores idempotentes, DLQ y AsyncAPI.
esc
↑↓ navegar ↵ abrir