swagger-php如何编写集合数据的接口文档注释？

Question

疑问

如题，最近开始研究swagger-php,文档和示例都翻了几遍，还是有点不太明白怎么定义definition，才能通过自由组合完成下方代码API文档的编写。疑问如下：

• 如果我分别定义部门模型和权限模型，那么在返回类似下面这样的数据的时候，怎么才能把权限模型嵌套进部门模型？
• 还是下面的数据，我希望将分页统一定义到一个definition中，这里该怎么引用？

返回的JSON数据如下：

{
    "message": "OK",
    "data": {
        "current_page": 1,
        "data": [
            {
                "id": 1,
                "role_name": "管理员",
                "status": 1,
                "created_at": "2018-03-05 09:41:01",
                "updated_at": "2018-03-05 09:41:01",
                "permission": []
            },
            {
                "id": 2,
                "role_name": "技术部",
                "status": 1,
                "created_at": "2018-03-05 09:41:01",
                "updated_at": "2018-03-05 09:41:01",
                "permission": [
                    {
                        "id": 5,
                        "permission_name": "权限列表",
                        "pid": 0,
                        "api_url": "PermissionController@index",
                        "client_url": "/permission/index",
                        "created_at": "2018-03-05 09:41:01",
                        "updated_at": "2018-03-05 09:41:01"
                    }
                ]
            }
        ],
        "first_page_url": "http://t.xxx/api/role?page=1",
        "from": 1,
        "next_page_url": null,
        "path": "http://t.xxx/api/role",
        "per_page": 10,
        "prev_page_url": null,
        "to": 2
    }
}

最后感谢各位大佬百忙之中回答我的提问 :-)