The Design of Web APIs

Guía metodológica y exhaustiva escrita por Arnaud Lauret (conocido en la industria como 'API Handyman') y publicada por Manning en 2019, dedicada exclusivamente a la fase de diseño de APIs web bajo un enfoque centrado en el consumidor (outside-in). La obra se fundamenta en los estándares modernos de la web, haciendo uso de HTTP y la especificación OpenAPI 3.0. Está dirigida a desarrolladores backend, arquitectos de software y líderes técnicos de nivel intermedio que ya comprenden los fundamentos del protocolo HTTP y buscan una metodología sistemática para diseñar interfaces intuitivas, predecibles y mantenibles antes de escribir una sola línea de código en el servidor.

El recorrido formativo enseña a descomponer objetivos de negocio en capacidades concretas mediante la herramienta API Goals Canvas. Lauret aborda en detalle el modelado de recursos, la jerarquía de URIs, el uso riguroso de métodos HTTP (GET, POST, PUT, DELETE y PATCH), la selección precisa de códigos de estado y la estructuración de cargas útiles de petición y respuesta. Asimismo, profundiza en la definición formal de esquemas con JSON Schema dentro de OpenAPI 3.0, patrones de seguridad (OAuth 2.0, API keys y alcances o scopes), optimización del rendimiento en red (paginación por cursor y desplazamiento, filtrado, almacenamiento en caché con ETags y operaciones por lotes) y técnicas para evolucionar contratos sin romper la retrocompatibilidad mediante políticas controladas de versionado y obsolescencia.

A lo largo del libro no se construye una aplicación ejecutable ni se configura infraestructura, ya que el autor separa deliberadamente el diseño de la interfaz de los detalles de implementación (omitiendo frameworks backend, bases de datos o despliegues). En su lugar, todos los conceptos se aplican en el diseño de una API bancaria realista (gestión de cuentas, titulares y transferencias) y se afianzan mediante ejercicios prácticos al final de los capítulos, cuyas soluciones se incluyen en el apéndice. Es una lectura imprescindible que aporta rigor a la ergonomía de las interfaces de programación; conviene tener experiencia previa en consumo o creación básica de servicios web para aprovechar al máximo las sutilezas de diseño que plantea.