README

What is this repository for?

This repo formats the response for API endpoints displaying information that is crucial for debugging and day-to-day operations.

How do I get set up?

Install the package and both middleware and response facade will be automatically discovered.

Behind the scenes

When a request is triggered, the following happens:

• a middleware injects a requestId in the header so that all responses will have it available
• the response facade kicks in and checks if the request expects a json response or is ajax which defines an API endpoint
• at this point the response will then format all the data that is needs to be outputted

Usage

There are 5 methods available in the package that will format a Response. One is the main method and the other 4 are wrappers for simpler calls. The following methods are available:

Examples

Code

$data = $model->get(1);
return Response::success($data);

Response

{
    "status": "success",
    "statusCode": 200,
    "data": {
        "user": {
            "name": "John Smith"
        }
    },
    "requestId": "662d5de536b97",
    "timestamp": 1714249189.23148
}