按团队获取成员列表

重要提示

该功能为 尊享版 付费功能，如未升级，请先 升级 后再使用

接口概述

• 功能：按团队获取成员列表
• 请求方式：GET
• 请求地址：/api/contacts/teams/{team_id}/users?appid={appid}&access_token={access_token}&page={1}&per_page={10}

请求参数

参数名	类型	必须	参数位置	描述	示例值
team_id	integer	是	uri	团队ID	30
page	integer	否	queryString	当前页码	1
per_page	integer	否	queryString	每页显示条数	10
roles	array	否	queryString		[1,2,3]

响应参数

参数名	类型	描述
total	integer	用户总数
list	array[object]	用户列表
list[_].avatar	string	用户头像
list[_].group_full_name	string	所属分组路径
list[_].is_org_available	integer
list[_].is_org_creator	integer
list[_].name	string	用户姓名
list[_].respon_id	integer
list[_].role	integer	用户权限角色
list[_].user_id	integer	用户ID
list[_].group_id	integer	所属分组ID

响应示例

• 请求成功

{
    "code": "OK",
    "error": {
        "type": ""
    },
    "data": {
        "total": 1,
        "list": [
            {
                "avatar": "https://wj.gtimg.com/default/default_headimg.png",
                "group_full_name": "测试组/测试子组",
                "is_org_available": true,
                "is_org_creator": false,
                "name": "jeterli3",
                "respon_id": 0,
                "role": 3,
                "user_id": 60000000285,
                "group_id": 6031
            }
        ]
    },
    "request_id": "d7c407f1-95c3-4fce-b7fc-90ba22602b99"
}

• 请求失败

{
    "code": "PermissionDenied",
    "error": {
        "type": "claim_error"
    },
    "data": {},
    "request_id": "5ffeb778-6046-42b2-b6f7-0c79ebc82288"
}

错误码

error.type 错误代码	错误描述
claim_error	无权限
invalid_argument	参数校验不通过