Skip to content
/ metapi Public

Laravel API helpers including benchmarking and interactive browsing

License

Notifications You must be signed in to change notification settings

fumeapp/metapi

Repository files navigation

Own your endpoint

metapi's main purpose is to help make sure your endpoint responses are consistent. By using the built in helper functions like ->option()...->verify, ->render(), ->success() and ->error() they will all share the same consistent standardized output reflecting the options available, parameters provided, and results.

Latest Stable Version Total Downloads codecov

Dracula dark theme with laravel-debugbar

Features

  • Endpoint benchmarking
  • Laravel Validation wrapper that reflects requirements
  • Support for JSON and JSONP
  • Interactive tree browsing with search thanks to jsoneditor
  • Dracula Dark theme support to pair with laravel-debugbar

Installation

Install metapi with composer:

composer require acidjazz/metapi

Add the trait

(app/Http/Controllers/Controller.php is recommended)

<?php

use acidjazz\metapi\MetApi;
class Controller
{
    use Metapi;

Examples

<?php

namespace App\Http\Controllers;

use acidjazz\metapi\MetApi;

class OrgController extends Controller
{

  use MetApi;

    /**
    * Display a listing of the resource.
    *
    * @return \Illuminate\Http\Response
    */
    public function index(Request $request)
    {
        $this
          ->option('approved', 'nullable|boolean');
          ->option('type', 'nullable|in:this,that');
          ->verify();
        ...
        $this->render($results);

GET /endpoint?approved=1

{
    "benchmark": 0.011060953140258789,
    "query": {
        "defaults": [],
        "options": {
            "approved": "nullable|boolean",
            "type": "nullable|in:this,that"
        },
        "params": {
            "approved": "1"
        },
        "combined": {
            "approved": "1"
        }
    },
    "data": [
        {

GET /endpoint?callback=bob

bob({
    "benchmark": 0.011017084121704102,
    "query": {
        "defaults": [],
        "options": {
            "approved": "nullable|boolean",
            "type": "nullable|in:this,that"
        },
        "params": [],
        "combined": []
    },
    "data": [
        {

Add custom attributes to validation.

    public function send(Request $request)
    {
        $this->option('contact.email', 'required|email', [], 'Email Address')
            ->option('contact.name', 'required|string', [], 'Firstname')
            ->option('contact.surname', 'required|string', [], 'Lastname')
            ->verify();
        ...
        $this->render($results);
    }

POST /send

{
    "status": "error",
    "errors": [
        {
            "status": 400,
            "message": "contact.email",
            "detail": "Email Address is a required field."
        },
        {
            "status": 400,
            "message": "contact.name",
            "detail": "Firstname is a required field."
        },
        {
            "status": 400,
            "message": "contact.surname",
            "detail": "Lastname is a required field."
        }
    ]
}