按团队获取成员列表

接口概述

• 功能：按团队获取成员列表
• 请求方式：GET
• 请求地址：/api/contacts/teams/{team_id}/users

请求参数

参数名	类型	必须	参数位置	描述	示例值
team_id	integer	是	uri	团队ID	30
page	integer	否	body	当前页码	1
per_page	integer	否	body	每页显示条数	10
roles	array	否	body		[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	参数校验不通过