模块说明
team 提供团队成员/组织的列表与详情接口:列表支持 class 筛选与分页,返回筛选选项 class_list;详情返回成员档案(含渲染介绍)。
鉴权级别:可选。
接口一览
| 方法 | URL | 鉴权 | 说明 |
|---|---|---|---|
| GET | /api/team |
可选 | 成员列表 |
| GET | /api/team/show/{id} |
可选 | 成员详情 |
列表
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
class |
否 | 分类筛选值(如按部门) |
page |
否 | 页码,默认 1 |
pageSize |
否 | 每页数量(0=用后台默认) |
响应
{
"code": "OK",
"message": "",
"data": {
"title": "团队",
"class": "",
"team_list": [ { "id": 1, "name": "...", "photo": "...", "...": "" } ],
"class_list": [ { "name": "全部", "value": "" }, { "name": "技术部", "value": "tech" } ],
"pager": { "page": 1, "page_size": 10, "record_count": 16, "page_count": 2 }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
详情
GET /api/team/show/2
{
"code": "OK",
"message": "",
"data": {
"title": "成员名",
"team": { "id": 2, "name": "...", "content": "<p>……</p>", "...": "" }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
注意事项
- 列表键为
team_list、详情键为team;class回显当前筛选值,class_list为可选项列表; - 详情可能附带
defined(自定义字段,如职务、联系方式); - 详情 ID 无效返回
422,记录不存在返回404。