Tema 1 · Configuración API

1. Filosofía API-First y Configuración de APIs en Laravel: install:api y routes/api.php

Aprende cómo habilitar el subsistema de API en Laravel moderno con php artisan install:api, el archivo routes/api.php y el middleware api con prefijo automático.

La Filosofía API-First en el Desarrollo Moderno

En el desarrollo de software contemporáneo, una aplicación rara vez es solo una página web servida por el backend. Los usuarios acceden desde aplicaciones móviles nativas (iOS y Android), clientes de escritorio, integraciones con terceros, extensiones y Single Page Applications (SPAs) en React, Vue o Next.js.

En lugar de crear lógica duplicada para cada plataforma, la estrategia API-First propone construir primero una API robusta, rápida y desacoplada que exponga los datos en formato JSON. Todas las interfaces de usuario consumen exactamente los mismos endpoints protegidos.

Configuración de APIs en Laravel Moderno (11 / 12)

A partir de Laravel 11, el framework adoptó una estructura ultraligera (lean skeleton). Las rutas de API ya no vienen incluidas por defecto en un proyecto nuevo para no sobrecargar proyectos que solo necesitan vistas Blade tradicionales.

Para activar el subsistema completo de API, se ejecuta el comando oficial de Artisan:

php artisan install:api

Este comando automatiza tres acciones críticas:

  1. Crea el archivo de rutas dedicado: routes/api.php.
  2. Registra el middleware de grupo api en bootstrap/app.php con el prefijo automático /api.
  3. Instala y publica las migraciones de Laravel Sanctum para autenticación mediante tokens personales.

⚡ Configuración de Rutas de API en bootstrap/app.php y routes/api.php

Estructura moderna de configuración en Laravel 11/12 para registrar y verificar rutas de API:

bootstrap/app.php
Solo lectura
<?php

use Illuminate\Foundation\Application;
use Illuminate\Foundation\Configuration\Exceptions;
use Illuminate\Foundation\Configuration\Middleware;

// Configuración moderna de enrutamiento en bootstrap/app.php
return Application::configure(basePath: dirname(__DIR__))
    ->withRouting(
        web: __DIR__.'/../routes/web.php',
        api: __DIR__.'/../routes/api.php',      // Archivo dedicado para endpoints REST
        apiPrefix: 'api',                       // Prefijo automático para todas las rutas
        commands: __DIR__.'/../routes/console.php',
        health: '/up',
    )
    ->withMiddleware(function (Middleware $middleware) {
        // Configuración de middlewares globales o grupos
        $middleware->api(prepend: [
            // Middlewares previos para la API si aplica
        ]);
    })
    ->withExceptions(function (Exceptions $exceptions) {
        // Manejador de excepciones en formato JSON
    })->create();
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Cuál es el comando de Artisan introducido en Laravel 11 para crear el archivo routes/api.php e instalar Laravel Sanctum automáticamente?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar APIs RESTful con Laravel, Resources & Sanctum y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.