多个招摇API

Question

我正在使用swagger来记录我的API，但现在我需要使用额外的API来扩展它。有没有办法创建2个json文件（2个API）e.a. /api/v1/public和/api/v1/private 它将共享某些模型/控制器的定义，但我需要将某些属性标记为只能访问某些API。

例如，如果我的模型users包含列name和some_internal_id，是否可以对这些属性进行分组，以便第一个属性同时属于两个API 第二个只属于私有API？

Answer 1

我使用php-swagger。在swagger配置文件中，您需要多次扫描多个JSON文件。例如，我的配置如下所示：

return [
    'Swagger' => [
        'docs' => [
            'public' => [
                'include' => [
                    ROOT . DS . 'src' . DS . 'Resources' . DS . 'Swagger' . DS . 'Public' . DS . 'Paths',
                    ROOT . DS . 'src' . DS . 'Resources' . DS . 'Swagger' . DS . 'Public' . DS . 'Definitions'
                ]
            ],
            'private' => [
                'include' => [
                    ROOT . DS . 'src' . DS . 'Resources' . DS . 'Swagger' . DS . 'Private' . DS . 'Paths',
                    ROOT . DS . 'src' . DS . 'Resources' . DS . 'Swagger' . DS . 'Private' . DS . 'Definitions'
                ]
            ]
        ]
    ]
];