kheredia04/api-responder

Un paquete elegante y consistente para estandarizar las respuestas JSON en tus APIs de Laravel.

dev-main 2026-07-17 13:17 UTC

Requires

• php: ^8.0
• illuminate/support: ^10.0|^11.0|^12.0|^13.0

MIT

Published on Packagist.org on 2026-07-17 13:17 UTC

README

Un paquete sencillo y elegante para estandarizar las respuestas de tus APIs en Laravel. Olvídate de repetir código y garantiza que tu API siempre devuelva una estructura JSON consistente.

Características

• Consistencia: Todas las respuestas siguen el mismo formato.
• Macros nativos: Usa response()->apiSuccess() directamente en tus controladores.
• Manejo de errores: Soporte nativo para excepciones y mensajes de error.
• Paginación: Formateo automático de colecciones paginadas.

Instalación

Instala el paquete a través de Composer:

composer require kheredia04/api-responder


Uso
Una vez instalado, el paquete registra automáticamente los macros en la fachada response()

// Respuesta exitosa simple
return response()->apiSuccess($data, 'Usuario obtenido con éxito');

// Respuesta con objeto individual
return response()->apiShowOne($user, 'Detalles del usuario');

// Respuesta de lista (colección)
return response()->apiShowAll($users, 'Lista de usuarios');

// Error personalizado
return response()->apiError('No autorizado', 403);

// Excepciones
// try {
    // ...
// } catch (\Throwable $th) {
    return response()->apiShowError($th, 500);
// }   

Estructura de la Respuesta
Todas las respuestas exitosas siguen este esquema

{
    "data": { ... },
    "message": "Mensaje opcional",
    "status": true,
    "code": 200
}