README

拥有自己的端点

metapi 的主要目的是确保您的端点响应一致性。通过使用内置辅助函数如 ->option()...->verify、->render()、->success() 和 ->error()，它们将共享相同的标准化输出，反映可用的选项、提供的参数和结果。

Dracula 暗色主题与 laravel-debugbar

功能

• 端点基准测试
• Laravel 验证包装器，反映要求
• 支持 JSON 和 JSONP
• 通过 jsoneditor 进行交互式树浏览和搜索
• 支持 Dracula 暗色主题，与 laravel-debugbar 配对

安装

使用 composer 安装 metapi

composer require acidjazz/metapi

添加特性

(推荐在 app/Http/Controllers/Controller.php 中添加)

<?php

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

示例

<?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": [
        {

将 自定义属性 添加到验证中。

    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."
        }
    ]
}