REST API Design Rulebook

Manual de estilo prescriptivo y conciso que compila una colección rigurosa de reglas normativas para diseñar interfaces web RESTful uniformes, intuitivas y predecibles. Escrito por Mark Massé, el libro está pensado para desarrolladores backend, diseñadores de software y arquitectos de nivel intermedio que conocen los conceptos elementales de la Web y buscan erradicar la ambigüedad, el desorden sintáctico y la disparidad de criterios en la construcción de endpoints HTTP.

La obra organiza sus directrices en categorías de diseño bien delimitadas: sintaxis de identificadores URI (jerarquías con barras oblicuas, uso de guiones frente a guiones bajos, omisión de extensiones de archivo o barras finales, y nomenclatura en plural para colecciones), modelado semántico de interacciones HTTP/1.1 (aprovechamiento estricto de métodos GET, POST, PUT, DELETE y PATCH según su seguridad e idempotencia), y aplicación sistemática de códigos de estado HTTP (200, 201, 204, 400, 404, entre otros). Asimismo, aborda la gestión de metadatos mediante cabeceras estándar para caché y negociación de contenido, la estructura de representaciones en formatos JSON y XML, la integración de hipermedios vinculados (HATEOAS), y la resolución de limitaciones de clientes navegadores a través de CORS, JSONP y métodos de tunelización. Como complemento, el autor expone su propuesta formal del lenguaje WRML (Web Resource Modeling Language).

El libro carece de proyectos integrales o ejercicios de codificación; funciona deliberadamente como una guía de referencia rápida y un estándar de ingeniería por el que contrastar cualquier diseño de API. Su mayor valor reside en clarificar debates habituales de equipo sobre nombres de rutas, códigos de retorno y convenciones HTTP, permitiendo elaborar contratos limpios y consistentes. Deja fuera la implementación técnica en lenguajes concretos, la autenticación avanzada y la persistencia en bases de datos. Es un texto ideal para consultar de forma continua al momento de escribir especificaciones técnicas de endpoints.