团队与团队成员 API¶
管理后台:团队(Team)与团队成员管理,需管理员会话。
列出团队¶
- 接口地址:
/team/list
- HTTP请求方式
GET
- 请求参数
- 响应代码
共通响应
响应示例:
JSON:
{ "data": [ { "id": "1", "name": "team-name", "domain_id": "1", "url": "/team/detail/1", "user": "admin" } ], "code": 0, "message": "OK" }
创建团队¶
- 接口地址:
/team/:domain/create
- HTTP请求方式
POST
- 请求参数
domain (path): 根域名
name (form, required): 团队名称,仅字母与连字符
domain (form, required): 同上根域名
user (form, required): 负责人用户名(该域下成员)
- 响应代码
0: 成功
1: 参数错误、无权限、团队已存在等
示例:
curl -X POST "$BASE_URL/team/example.com/create" -d "name=dev-team&domain=example.com&user=admin"
团队成员列表(页面)¶
- 接口地址:
/team/member/list/:id
- HTTP请求方式
GET
- 请求参数
id (path): 团队 ID
- 响应代码
共通响应
说明:返回该团队下的成员列表(含域名成员或团队成员)。id 为当前域时返回域下成员。
团队成员列表(API)¶
- 接口地址:
/api/team/member/list/:id
- HTTP请求方式
GET
- 请求参数
id (path): 团队 ID
- 响应代码
共通响应
响应示例:
JSON:
{ "data": [ { "id": "1", "url": "/member/1/detail/1", "name": "Admin", "user": "admin", "type": 0, "email": "admin@example.com" } ], "code": 0, "message": "OK" }
创建团队成员¶
- 接口地址:
/team/member/create/:id
- HTTP请求方式
POST
- 请求参数
id (path): 团队 ID
email (form, required): 成员邮箱,须为本域下已存在用户(如 user@example.com)
- 响应代码
0: 成功
1: 参数错误、无权限、用户不存在等
示例:
curl -X POST "$BASE_URL/team/member/create/1" -d "email=user@example.com"
页面路由(非 JSON API)¶
GET /team - 团队管理页
GET /team/:domain - 某域名下团队详情/列表页
GET /team/member/:id - 某团队成员管理页