README

Laravel 控制器类，允许在没有设置 "accept" 标头为 json 的情况下输出 API 文档。

配置

将以下内容添加到您的 composer.json 文件中，并执行 composer update / composer install

{
    "require": {
        "dwolf555/api-docs-controller": "dev-master"
    }
}

将以下内容添加到您的 app/config/app.php 配置文件的 providers 数组中

'Dwolf555\ApiDocsController\ApiDocsControllerServiceProvider',

示例控制器

class UserController extends Dwolf555\ApiDocsController\ApiDocsController {

    /**
     * Display a listing of the resource.
     *
     * @return Response
     */
    public function index()
    {
        // For documentation
        $this->apiDocInfo = [
            'wordOfWarning' => 'Just be ok, ok?',
            'exampleResponse' => ['message' => 'ok'],
            'inputs' => [
                'limit' => 10,
                'offset' => 0
            ],
            'possibleErrors' => [
                'limit' => 'Limit must be a valid integer.',
                'offset' => 'Limit must be a valid integer.',
            ]
        ];

        $content = array(
            'actualcontent' => 'realstuff'
        );
        $statusCode = 200;

        return $this->generateResponse($content, $statusCode);
    }

}

dwolf555 / api-docs-controller

维护者

详细信息

README

配置

示例控制器

示例输出