Tema 3 · Controladores API

3. Controladores API y Route Model Binding Implícito y Scoped

Crea controladores con artisan make:controller --api y delega la búsqueda automática y errores 404 en el Route Model Binding de Eloquent.

Generación de Controladores Dedicados a APIs

Para mantener el proyecto ordenado y limpio, los controladores de API deben colocarse en su propio namespace dedicado: App\Http\Controllers\Api\V1.

Artisan permite generar el esqueleto con los 5 métodos API mediante la bandera --api:

php artisan make:controller Api/V1/ProductoController --api --model=Producto

La Magia del Route Model Binding Implícito

En lugar de recibir el ID como entero y escribir manualmente $producto = Producto::find($id); if (!$producto) abort(404);, Laravel realiza Route Model Binding automático:

public function show(Producto $producto): JsonResponse
{
    // Laravel ya buscó el producto en la BD por su ID.
    // Si no existía, arrojó automáticamente una excepción HTTP 404 en formato JSON!
    return response()->json($producto);
}

⚡ Controlador API Básico con Inyección de Modelos

Ejemplo de controlador API con Model Binding implícito en Laravel:

app/Http/Controllers/Api/V1/ProductoController.php
Solo lectura
<?php

namespace App\Http\Controllers\Api\V1;

use App\Http\Controllers\Controller;
use App\Models\Producto;
use Illuminate\Http\Request;
use Illuminate\Http\JsonResponse;

class ProductoController extends Controller
{
    /**
     * GET /api/v1/productos
     */
    public function index(): JsonResponse
    {
        $productos = Producto::latest()->paginate(15);
        return response()->json($productos);
    }

    /**
     * GET /api/v1/productos/{producto}
     * Typehinting de Producto activa Route Model Binding automáticamente
     */
    public function show(Producto $producto): JsonResponse
    {
        return response()->json($producto);
    }

    /**
     * DELETE /api/v1/productos/{producto}
     */
    public function destroy(Producto $producto): JsonResponse
    {
        $producto->delete();
        return response()->json(null, 204); // 204 No Content
    }
}
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Qué ocurre automáticamente si un cliente solicita GET /api/v1/productos/999 y el ID 999 no existe en la base de datos con Route Model Binding?
🦉
¿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.