myerscode / laravel-api-response by oniice

A fluent helper and facade to ensure consistent, idempotent API responses in Laravel and Lumen
17,390
4
2
Package Data
Maintainer Username: oniice
Maintainer Contact: team@myerscode.com (myerscode)
Package Create Date: 2018-05-07
Package Last Update: 2024-09-15
Home Page:
Language: PHP
License: MIT
Last Refreshed: 2024-11-21 03:00:43
Package Statistics
Total Downloads: 17,390
Monthly Downloads: 821
Daily Downloads: 25
Total Stars: 4
Total Watchers: 2
Total Forks: 0
Total Open Issues: 0

Laravel API Response

A fluent helper to provide a consistent shaped API responses in Laravel

Latest Stable Version Total Downloads License

Why is this package helpful?

This package ensures your API will always return the same envelope shape, so consuming apps always know what to expect!

Install

You can install this package via composer:

composer require myerscode/laravel-api-response

Usage

In a Laravel controller you just to build up your response and return it!

The api() helper return a Response Builder and as it implements the Responsable trait you dont need to do anything more than return the builder

Using the api() helper function

function resource()
{
    return api()->status(201)->data(['name' => 'Foo Bar'])->message('Record Created!');
}

Using a Builder class


function resource() {
    $buillder = new Builder();
    $builder->status(201)->data(['name' => 'Foo Bar'])->message('Record Created!');
    return $builder;
}

Would return the following JSON response.

{
    "status": 201,
    "data": {
        "name": "Foo Bar"
    },
    "meta": [],
    "messages": [
        "Record Created!"
    ]
}

License

The MIT License (MIT). Please see License File for more information.