Download the PHP package hardcodear/api-response-service without Composer
On this page you can find all versions of the php package hardcodear/api-response-service. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download hardcodear/api-response-service
More information about hardcodear/api-response-service
Files in hardcodear/api-response-service
Package api-response-service
Short Description Servicio para formatear respuestas JSON en Laravel
License MIT
Homepage https://github.com/hardcodear/api-response-service
Informations about the package api-response-service
Api Response Service
Paquete Laravel 12+ (incluye Laravel 13) para formatear respuestas JSON de forma estandarizada.
Este paquete proporciona una forma consistente de estructurar las respuestas JSON para APIs Laravel, siguiendo un formato uniforme para respuestas exitosas y de error.
✅ Compatibilidad
- PHP
8.2+ - Laravel
12+(incluye13)
📦 Instalación
Instalar el paquete
En consola:
Laravel detectará automáticamente el ServiceProvider y registrará el alias del facade apiresponse gracias al archivo composer.json del paquete.
⚡ Quick Start
🧰 Funcionalidades disponibles
El paquete expone los siguientes métodos a través del helper apiresponse() (o facade ApiResponse):
✅ Respuestas exitosas
📭 Not Found (404)
🛑 Validación fallida (422)
🔐 No autorizado (401)
🚫 Prohibido (403)
💥 Error del servidor (500)
❌ Errores personalizados
🧪 Estructura del JSON resultante
Éxito
Error
El campo
errorspuede ser un array plano o un array asociativo (por ejemplo, errores de validación).Cuando
dataoerrorssonnull, esas claves se omiten automáticamente del JSON.
📌 Manejo global de excepciones (opcional)
Si querés que tu API devuelva respuestas JSON uniformes ante errores comunes como rutas no encontradas, permisos o límites de peticiones, podés usar el registrador de excepciones incluido en este paquete.
Esto te permite centralizar el manejo de errores en bootstrap/app.php, sin repetir lógica en cada controlador.
🧱 Editar bootstrap/app.php
Agregá el binding dentro de withExceptions(...) en bootstrap/app.php:
⚙️ ¿Qué hace esto?
Intercepta excepciones comunes y devuelve respuestas formateadas como:
Las excepciones manejadas por defecto son:
- AccessDeniedHttpException → 401 Unauthorized
- NotFoundHttpException → 404 Not Found
- TooManyRequestsHttpException → 429 Too Many Requests
- RouteNotFoundException → 401 Unauthorized
- AuthenticationException → 401 Unauthorized
- AuthorizationException → 403 Forbidden
- MethodNotAllowedHttpException → 405 Method Not Allowed
- ValidationException → 422 Unprocessable Entity
- HttpExceptionInterface (fallback) → respeta el status HTTP en rutas API
⚙️ Configuracion opcional (v1.1)
Si queres personalizar patrones de rutas y mensajes, publica la configuracion:
Archivo publicado: config/apiresponse.php
api_patterns: patrones de ruta a interceptar (default:['api', 'api/*'])messages: mensajes por tipo de excepcion
🧪 Testing
Ejecutar la suite localmente:
El repositorio también ejecuta tests automáticamente en GitHub Actions para push y pull_request con PHP 8.2 y 8.3, validando Laravel 12 y 13 en combinaciones compatibles.
Matriz de CI actual:
| PHP | Laravel |
|---|---|
8.2 |
12 |
8.3 |
12 |
8.3 |
13 |
🧑 Autor
Ricardo Bazán
Argentina, 2026
Repositorio interno: https://github.com/hardcodear/api-response-service
📄 Licencia
Este paquete está licenciado bajo la MIT License.
All versions of api-response-service with dependencies
illuminate/support Version ^12.0|^13.0
illuminate/http Version ^12.0|^13.0
illuminate/auth Version ^12.0|^13.0