Cómo instalar la API en Laravel

Si todavía no sabes que es una API (Application Programming Interface), te hago un resumen rápido:

Una API es una pieza de código que permite a diferentes aplicaciones comunicarse entre sí y compartir información y funcionalidades. Una API es un intermediario entre dos sistemas, que permite que una aplicación se comunique con otra y pida datos o acciones específicas.

Wikipedia

En Laravel, normalmente utilizamos la API para llevar a cabo el desarrollo de servicios REST, principalmente para ofrecer recursos a aplicaciones móviles, SPA o cualquier aplicación ajena a nosotros que necesite consumir nuestra información. Aunque también podemos utilizar la API de Laravel en formato REST para consumir recursos desde el mismo proyecto utilizando Vue, React o Svelte entre otros frameworks JavaScript.

No te pierdas el curso API REST en Laravel 11 con Laravel Sanctum.

Cómo instalar la API en Laravel 11 y Laravel 12

Instalar la API en Laravel 11 y Laravel 12 es realmente sencillo, basta con ejecutar un comando, el cual creará todo lo necesario para poder desarrollar nuestras APIs en Laravel haciendo uso de Laravel Sanctum.

En versiones anteriores de Laravel, la API ya venía instalada y configurada por defecto sin hacer nada, pero ya que no todos los proyectos requieren del desarrollo de una API, no tiene sentido que venga de saque porque sí, así que es una buena elección hacer que la API en Laravel sea opcional.

A continuación, te muestro lo que debes hacer para instalar la API en Laravel, basta con ejecutar el siguiente comando en un terminal ubicado en tu proyecto:

Una vez ejecutado el comando anterior, tendremos casi todo listo para poder empezar a generar tokens con Laravel Sanctum para nuestros usuarios, para ello, antes, deberemos añadir el siguiente Trait al modelo User:

¿Qué ocurre al instalar la API en Laravel?

Lo que ha pasado al instalar la API en Laravel ha sido lo siguiente:

• Se ha creado la migración para crear la tabla personal_access_tokens, que es utilizada para gestionar los tokens con Sanctum.

• Se ha añadido todo lo necesario para utilizar Laravel Sanctum, que es quién gestiona la lógica haciendo uso de tokens.

• Se ha creado el archivo routes/api.php, desde donde podemos crear nuestros endpoints para servir nuestra API en Laravel.

• Se ha actualizado el archivo bootstrap/app.php para registrar las rutas API en el método withRouting.

Tu primer endpoint de API en Laravel

Una vez instalada la API, puedes crear tu primer endpoint abriendo el archivo routes/api.php y añadiendo lo siguiente:

Ahora puedes acceder a http://tu-proyecto.test/api/status y verás la respuesta JSON. Así de sencillo es empezar a desarrollar APIs en Laravel.

Errores comunes al instalar la API en Laravel

Estos son los problemas más frecuentes que puedes encontrar:

• Error "Route [api] not defined": Asegúrate de haber ejecutado las migraciones con php artisan migrate después de instalar la API.

• Token no funciona: Verifica que has añadido el trait HasApiTokens al modelo User.

• Error 401 Unauthorized: Si estás usando rutas protegidas con auth:sanctum, necesitas enviar el token en el header Authorization como Bearer {token}.

Sanctum vs Passport: ¿Cuál elegir?

Laravel ofrece dos opciones principales para autenticación de APIs:

• Laravel Sanctum (recomendado): Ideal para SPAs, aplicaciones móviles y APIs simples. Es ligero y viene por defecto con php artisan install:api.

• Laravel Passport: Implementación completa de OAuth2. Úsalo solo si necesitas OAuth2 para terceros o integraciones empresariales complejas.

Para la mayoría de proyectos, Sanctum es la mejor opción por su simplicidad y rendimiento.

Próximos pasos

Ahora que tienes la API instalada, te recomiendo continuar con estos recursos:

• ¿Qué es Laravel Sanctum? SPA y API Tokens - Profundiza en cómo funciona Sanctum.

• API Resources en Laravel - Aprende a formatear las respuestas de tu API.

• Guía Completa de JWT en Laravel - Alternativa a Sanctum con tokens JWT.

• Curso: API REST en Laravel 11 - Curso completo para dominar el desarrollo de APIs.

De esta forma tan sencilla, ya puedes empezar a desarrollar tu próxima gran idea en forma de API en Laravel, espero que te haya servido.

Preguntas frecuentes

¿El comando install:api funciona en Laravel 12?

Sí, el comando php artisan install:api funciona tanto en Laravel 11 como en Laravel 12. El proceso es idéntico en ambas versiones.

¿Puedo usar la API sin Sanctum?

Sí, puedes crear endpoints en routes/api.php sin autenticación o usar otras soluciones como JWT. Sanctum es opcional pero recomendado.

¿Dónde se guardan los tokens de Sanctum?

Los tokens se almacenan en la tabla personal_access_tokens que se crea con la migración al ejecutar php artisan install:api.