Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/marcinorlowski/laravel-api-response-builder

Builds nice, normalized and easy to consume REST JSON responses for Laravel powered APIs.
https://github.com/marcinorlowski/laravel-api-response-builder

api api-helper chained-apis json json-response laravel php rest-api

Last synced: 1 day ago
JSON representation

Builds nice, normalized and easy to consume REST JSON responses for Laravel powered APIs.

Host: GitHub
URL: https://github.com/marcinorlowski/laravel-api-response-builder
Owner: MarcinOrlowski
License: mit
Created: 2016-04-11T20:43:12.000Z (almost 9 years ago)
Default Branch: master
Last Pushed: 2024-12-12T11:17:24.000Z (about 2 months ago)
Last Synced: 2025-02-06T02:23:55.779Z (1 day ago)
Topics: api, api-helper, chained-apis, json, json-response, laravel, php, rest-api
Language: PHP
Homepage:
Size: 1.9 MB
Stars: 745
Watchers: 17
Forks: 82
Open Issues: 2
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: docs/CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        ![REST API Response Builder for Laravel](artwork/laravel-api-response-builder-logo.png)

# REST API Response Builder for Laravel #

[![Latest Stable Version](https://poser.pugx.org/marcin-orlowski/laravel-api-response-builder/v)](https://packagist.org/packages/marcin-orlowski/laravel-api-response-builder)

[![Codacy Grade Badge](https://api.codacy.com/project/badge/Grade/44f427e872e2480597bde0242417a2a7)](https://www.codacy.com/app/MarcinOrlowski/laravel-api-response-builder)

[![Monthly Downloads](https://poser.pugx.org/marcin-orlowski/laravel-api-response-builder/d/monthly)](https://packagist.org/packages/marcin-orlowski/laravel-api-response-builder)

[![Code Quality](https://scrutinizer-ci.com/g/MarcinOrlowski/laravel-api-response-builder/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/MarcinOrlowski/laravel-api-response-builder/?branch=master)

[![Code Coverage](https://codecov.io/gh/MarcinOrlowski/laravel-api-response-builder/branch/master/graph/badge.svg?token=s3WnvhiI7n)](https://codecov.io/gh/MarcinOrlowski/laravel-api-response-builder)

[![License](https://poser.pugx.org/marcin-orlowski/laravel-api-response-builder/license)](https://packagist.org/packages/marcin-orlowski/laravel-api-response-builder)

Master branch:

[![Unit Tests](https://github.com/MarcinOrlowski/laravel-api-response-builder/actions/workflows/phpunit.yml/badge.svg?branch=master)](https://github.com/MarcinOrlowski/laravel-api-response-builder/actions/workflows/phpunit.yml)

[![Static Analysis](https://github.com/MarcinOrlowski/laravel-api-response-builder/actions/workflows/phpstan.yml/badge.svg?branch=master)](https://github.com/MarcinOrlowski/laravel-api-response-builder/actions/workflows/phpstan.yml)

[![Coding Standards](https://github.com/MarcinOrlowski/laravel-api-response-builder/actions/workflows/coding-standards.yml/badge.svg?branch=master)](https://github.com/MarcinOrlowski/laravel-api-response-builder/actions/workflows/coding-standards.yml)

Development branch:

[![Unit Tests](https://github.com/MarcinOrlowski/laravel-api-response-builder/actions/workflows/phpunit.yml/badge.svg?branch=dev)](https://github.com/MarcinOrlowski/laravel-api-response-builder/actions/workflows/phpunit.yml)

[![Static Analysis](https://github.com/MarcinOrlowski/laravel-api-response-builder/actions/workflows/phpstan.yml/badge.svg?branch=dev)](https://github.com/MarcinOrlowski/laravel-api-response-builder/actions/workflows/phpstan.yml)

[![Coding Standards](https://github.com/MarcinOrlowski/laravel-api-response-builder/actions/workflows/coding-standards.yml/badge.svg?branch=dev)](https://github.com/MarcinOrlowski/laravel-api-response-builder/actions/workflows/coding-standards.yml)

## Table of contents ##

* [Introduction](#introduction)

* [Why should I use it?](#benefits)

* [Usage examples](docs/examples.md#usage-examples)

* [Features](#features)

* [Extensive documentation](docs/README.md)

* [License](#license)

* [Changelog](docs/CHANGES.md)

----

## Introduction ##

 `ResponseBuilder` is a [Laravel](https://laravel.com/) package, designed to help you build a nice, normalized and easy to consume

 REST API JSON responses.

## Benefits ##

 `ResponseBuilder` is written for REST API developers by REST API developer and is based on long-lasting experience on both

 "sides" of API. It's lightweight, with **no** dependencies, extensively tested and simple to use yet flexible and powerful,

 with support for [on-the-fly data conversion](docs/conversion.md), [localization support](docs/docs.md#messages-and-localization),

 automatic message building, [chained APIs](docs/docs.md#code-ranges) and (hopefully) [exhaustive documentation](docs/README.md).

 But that's not all! The JSON structure produced by `ResponseBuilder` is designed with **users of your API** in mind, so its

 structure is predictible and [well-defined](docs/docs.md#response-structure) which makes dealing with your API using

 `ResponseBuilder` library a breeze. Simple JSON response, with well-defined and predictable structure, easy to consume

 without any hassle or trickery. **Your** clients will love it. And will love **you** too :)

 You are also covered in a case of emergency, as provided [ExceptionHandlerhelper](docs/exceptions.md), ensures your API keeps

 talking JSON (and NOT lame HTML) to its clients even in case of unexpected.

 Did I mention, you would also get [testing traits](docs/testing.md) that automatically add PHPUnit based unit test to your

 whole `ResponseBuilder` related code and configuration with just a few lines of code **absolutely for free**?

## Features ##

* [Easy to use](docs/examples.md#usage-examples),

* [Stable and production ready](https://travis-ci.org/MarcinOrlowski/laravel-api-response-builder),

* [On-the-fly data object conversion](docs/conversion.md),

* [API chaining support](docs/docs.md#code-ranges),

* [Localization support](docs/docs.md#messages-and-localization),

* Provides traits to help [unit test your API code](docs/testing.md),

* Comes with [exception handler helper](docs/exceptions.md) to ensure your API stays consumable even in case of unexpected,

* [No additional dependencies](composer.json).

## License ##

* Written and copyrighted ©2016-2024 by Marcin Orlowski 

* ResponseBuilder is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT)