获取团队信息（token）
GET /v2/team/
- 用户查看团队信息，该接口返回的是一个list，且不包含成员信息，成员信息请使用/v2/member/list/或/v2/member/接口；如果取到的list为空，请使用POST方法创建团队。
请求参数
无
返回值
{
"meta": {
"message": "团队list",
"code": 0
},
"data": [
....
]
}
错误码
| 错误代码 | 错误说明 |
|---|---|
| 29070 | 需要企业用户权限 |
创建团队（token）
POST /v2/team/
- 创建团队。
请求参数
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| alias | string | 否 | 团队名称，默认为公司名 |
返回值
{
"meta": {
"message": "团队创建成功",
"code": 0
},
"data": {
....
}
}
错误码
| 错误代码 | 错误说明 |
|---|---|
| 29070 | 需要企业用户权限 |
获取团队成员列表（token）
GET /v2/team/member/list
- 获取团队成员列表。
请求参数
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| teamid | string | 是 | 团队id |
注： /v2/team/(get)可以取到teamid
返回值
{
"meta": {
"message": "成员list",
"code": 0
},
"data": {
....
}
}
错误码
| 错误代码 | 错误说明 |
|---|---|
| 29010 | 缺少teamid参数 |
| 29060 | 团队不存在 |
| 29070 | 需要企业用户权限 |
添加成员（token）
POST /v2/team/member/
- 向团队里添加成员。
请求参数
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| identification | string | 是 | 成员邮箱 |
| teamid | string | 是 | 团队ID |
返回值
{
"meta": {
"message": "添加成功！",
"code": 0
},
"data": {
....
}
}
错误码
| 错误代码 | 错误说明 |
|---|---|
| 29010 | 参数错误 |
| 29030 | 要添加的用户不存在 |
| 29060 | 团队不存在 |
| 29061 | 需要管理员权限 |
| 29062 | 你不在该团队里 |
| 29063 | 用户已经在该团队里 |
| 29070 | 需要企业用户权限 |
获取单个成员信息（token）
GET /v2/team/member/
- 获取单个成员信息。
请求参数
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| identification | string | 是 | 成员邮箱 |
| teamid | string | 是 | 团队ID |
返回值
{
"meta": {
"message": "成员信息",
"code": 0
},
"data": {
....
}
}
错误码
| 错误代码 | 错误说明 |
|---|---|
| 29010 | 参数错误 |
| 29030 | 要查询的用户不存在 |
| 29060 | 团队不存在 |
| 29061 | 需要管理员权限 |
| 29062 | 用户不在该团队里 |
| 29063 | 用户已经在该团队里 |
| 29070 | 需要企业用户权限 |
删除成员（token）
GET /v2/team/member/
- 删除成员。
请求参数
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| identification | string | 是 | 成员邮箱 |
| teamid | string | 是 | 团队ID |
返回值
{
"meta": {
"message": "删除成功",
"code": 0
},
"data": {
....
}
}
错误码
| 错误代码 | 错误说明 |
|---|---|
| 29010 | 参数错误或不能删除自己 |
| 29030 | 要删除的用户不存在 |
| 29060 | 团队不存在 |
| 29061 | 需要管理员权限 |
| 29062 | 用户不在该团队里 |
| 29063 | 用户已经在该团队里 |
| 29070 | 需要企业用户权限 |
