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:
<?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¿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.