Principles of Web API Design

Tratado de referencia publicado por Addison-Wesley en 2021 dentro de la serie Vernon, escrito por el consultor y arquitecto James Higginbotham. La obra introduce una metodología estructurada para guiar el diseño de APIs web y microservicios a partir del valor de negocio que deben ofrecer. Aunque parte de principios fundamentales que la hacen accesible a quienes se inician en la arquitectura de APIs (nivel básico a intermedio), requiere conocimientos previos de desarrollo web y lógica de software para comprender cómo transformar flujos organizacionales en interfaces digitales reutilizables.

Higginbotham introduce su método colaborativo ADDR (Align, Define, Design, Refine), integrando técnicas de diseño guiado por el dominio (Domain-Driven Design o DDD), Job Stories y talleres de EventStorming para identificar capacidades digitales y delimitar contextos de dominio (bounded contexts) sin caer en dependencias de bases de datos. A partir de esa alineación, aborda el diseño de interfaces según múltiples estilos arquitectónicos: APIs REST basadas en recursos y mensajes, llamadas RPC, consultas estructuradas mediante GraphQL y arquitecturas orientadas a eventos con AsyncAPI para streaming y mensajería asíncrona. También enseña a formalizar contratos con OpenAPI, formular estrategias de pruebas automatizadas y proteger las APIs mediante pasarelas (API gateways) y políticas de seguridad.

El libro no propone ejercicios de codificación ni construye una aplicación informática en un lenguaje concreto, sino que desarrolla un caso de estudio continuo de dominio empresarial donde se modelan colaborativamente capacidades, eventos y contratos de API a través de artefactos y diagramas de secuencia. Su aportación fundamental es desterrar el antipatrón de diseñar APIs exponiendo directamente esquemas relacionales o modelos de clases internas, enseñando a ver los contratos como acuerdos desacoplados entre productores y consumidores. Es una lectura esencial para aprender a dialogar entre negocio y desarrollo técnico antes de iniciar la implementación en microservicios.