Tema 4 · API Resources

4. Transformación de Datos con JsonResource: Ocultar Secretos y Dar Formato

Desacopla la estructura de tu base de datos del contrato JSON público utilizando clases JsonResource para ocultar hashes y formatear fechas.

¿Por qué NUNCA se debe retornar el modelo Eloquent directo?

Hacer return response()->json($usuario); directamente desde un controlador es un antipatrón peligroso conocido como fuga de esquema (Schema Leak).

Provoca graves problemas de seguridad y mantenibilidad:

  • Riesgo de Seguridad: Si olvidas agregar una columna a la propiedad $hidden del modelo, podrías exponer contraseñas hasheadas, tokens de dos factores (2FA) o datos privados de los clientes.
  • Acoplamiento Tóxico: Si renombras una columna en la base de datos (por ejemplo first_name a primer_nombre), romperás inmediatamente todas las aplicaciones frontend y móviles que consumen el JSON con el nombre antiguo.
Diagrama Técnico: Transformación de Datos con Eloquent API Resources

La capa JsonResource actúa como un adaptador que transforma el modelo interno en el contrato JSON externo.

Creación de un API Resource con Artisan

Para generar un recurso de transformación se utiliza:

php artisan make:resource ProductoResource

Dentro del método toArray($request) defines con total libertad qué atributos se envían, cómo se formatean las fechas y qué nombres tendrán las claves JSON.

⚡ Clase ProductoResource con Formateo y Conversión de Atributos

Ejemplo de clase JsonResource para transformar un modelo Producto antes de emitir el JSON:

app/Http/Resources/ProductoResource.php
Solo lectura
<?php

namespace App\Http\Resources;

use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;

class ProductoResource extends JsonResource
{
    /**
     * Transforma el recurso en un array serializable a JSON.
     *
     * @return array<string, mixed>
     */
    public function toArray(Request $request): array
    {
        return [
            'id'          => $this->id,
            'nombre'      => $this->nombre,
            'slug'        => $this->slug,
            'precio'      => (float)$this->precio,
            'precio_fmt'  => '$ ' . number_format((float)$this->precio, 2, ',', '.'),
            'disponible'  => $this->stock > 0,
            'stock'       => (int)$this->stock,
            'fecha_creado'=> $this->created_at?->toIso8601String(),
        ];
    }
}

// En el controlador:
// return new ProductoResource($producto);
🧠
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 beneficio primordial de utilizar Eloquent API Resources en lugar de serializar el modelo directamente con response()->json($modelo)?
🦉
¿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.