corporateip/laravel-api-response

A simple api response factory for Laravel

1.0.3 2024-09-12 06:59 UTC

Requires

• php: ^8.1

MIT

• Jimmy

README

This package aims to makes responses from the API consistent and easy to use. It is compliant with the HTTP standard and the JSend standard.

Example

Code

function getUser($id){
    // Get the data we wish to return
    $user = User:find($id);
    
    // If the user does not exist we return an error
    if(!$user){
        return ApiResponseFactory::notFound("User does not exist");
    }
    
    // Return the data by using a ReponseFactory
    return ApiResponseFactory::success($user);
}

Error output

{
  "status":"fail",
  "message":"User does not exist"
}

Success output

{
  "status":"success",
  "data": { 
      "id":1,
      "name":"John Doe",
      "email":"[e-mail]",
      "created_at":null,
      "updated_at":null
  }
}

Installation

To install you can use Composer, use the following command to install this package.
composer require corporateip/laravel-api-response

Documentation

Coming soon!

Progress

• JSend compliance
• PHPUnit tests
• Documentation

License

For the license please check the LICENSE file, this project has the MIT license.