CP团队管理接口文档


获取团队信息(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 需要企业用户权限
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,837评论 18 139
  • 点击查看原文 Web SDK 开发手册 SDK 概述 网易云信 SDK 为 Web 应用提供一个完善的 IM 系统...
    layjoy阅读 13,867评论 0 15
  • PentaQ 开放平台 API 接口一期设计文档 V4
    大名郑日天阅读 332评论 0 1
  • iOS网络架构讨论梳理整理中。。。 其实如果没有APIManager这一层是没法使用delegate的,毕竟多个单...
    yhtang阅读 5,237评论 1 23
  • 01. 最近我发现,越会休息的人越聪明,也越贵。 举个例子说,比如在deadline来临之前你有两件事要做。 普通...
    苏林深阅读 2,035评论 10 49