La mayoría de las APIs de Laravel que he heredado se torcieron de la misma manera, y nunca fue culpa del framework. Alguien había envuelto Eloquent en repositorios «por si acaso». Alguien había reemplazado los FormRequests por una validación propia. Pieza a pieza, habían abstraído el framework hasta sacarlo del framework.
Este libro toma el camino contrario. Laravel resuelve el enrutamiento, la validación, el acceso a la base de datos, la autenticación, las colas y los tests con un vocabulario único y coherente, pulido durante años de uso en producción. Los controladores, los FormRequests, los API Resources, las colas, el cliente HTTP: existen porque evitan errores, hacen posibles los tests y siguen funcionando cuando el equipo crece.
Comprométete con esas convenciones y dejarás de discutir los cimientos, y ese tiempo quedará libre para entregar.
De qué trata este libro
Este libro muestra una forma práctica y repetible de construir APIs con Laravel que sean fáciles de extender, fáciles de probar y predecibles para quienes las consumen. Sigue una sola API desde su primera ruta hasta producción, y luego más allá: la autenticación, el pipeline de la petición, los errores, las colas, los tests, la monitorización, el despliegue y lo que cambia cuando un servicio se convierte en varios.
El ejemplo conductor es real. La License API es un pequeño servicio interno de Krodox, una plataforma que aprovisiona sitios web, y los ejemplos de este libro están tomados de ese sistema. Es lo bastante pequeña para caber en la cabeza y lo bastante real para tener los problemas que un tutorial nunca tiene: un proveedor externo que no responde a tiempo, clientes que reintentan, jobs que se ejecutan dos veces.
Este libro es una filosofía más que un catálogo de patrones. Aquí no encontrarás cuarenta diagramas de arquitectura ni una abstracción a medida que prometa blindar tu código frente al futuro. Encontrarás un conjunto pequeño de reglas, aplicadas de la misma manera en cada endpoint, y una inclinación a borrar código antes que a inventarlo.
Para quién es este libro
Este libro está escrito para desarrolladores de Laravel que se manejan con soltura en HTTP, REST y PHP orientado a objetos. No hace falta que seas un experto en Laravel, pero sí que trabajes con el framework de forma habitual.
Para seguirlo necesitas PHP 8.5, Laravel 13, una base de datos y un editor.
Si has heredado una API inconsistente, o has visto acumularse la complejidad en una que escribiste tú, este libro ofrece una salida clara. Si construyes en equipo, te da una única manera de hacer las cosas que un desarrollador nuevo puede aprender leyendo un solo endpoint. Si quieres entregar funcionalidades hoy y poder seguir entregándolas dentro de dos años, se escribió para ti.