获取会话成员列表
适用版本>=v7.0.2411b.20241128
接口说明:获取会话成员列表
请求说明
| 请求地址 | 配置域名+/openapi+/v7/audit/chats/{chat_id}/members |
|---|---|
| 请求方法 | GET |
| 签名方式 | KSO-1(配置域名+/openapi不参与签名) |
| 权限要求 | 查询审计会话(应用授权) kso.chat_audit.read 读写审计会话(应用授权) kso.chat_audit.readwrite |
请求头(Header)
| Header | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| X-Kso-Date | string | 是 | RFC1123 格式的日期,例: Wed, 23 Jan 2013 06:43:08 GMT |
| X-Kso-Authorization | string | 是 | KSO-1 签名值,详见《签名方法》 |
| Authorization | string | 是 | 授权凭证,格式为:Bearer {access_token} |
路径参数(Query)
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| chat_id | int64 | 是 | 会话Id |
查询参数(Query)
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| page_size | int64 | 是 | 分页大小 大于0 小于等于100 |
| page_token | string | 否 | 翻页token |
响应体(Response)
| 名称 | 类型 | 说明 |
|---|---|---|
| code | integer | code |
| msg | string | msg |
| data | object | null |
| ∟ items | array[object] | |
| ∟ ∟ chat_id | string | 会话ID |
| ∟ ∟ id | string | 成员ID |
| ∟ ∟ identity | string | 成员身份结构 |
| ∟ ∟ ∟ avatar | string | 用户头像 |
| ∟ ∟ ∟ company_id | string | 用户所在企业 |
| ∟ ∟ ∟ id | string | 用户Id |
| ∟ ∟ ∟ name | string | 名称 |
| ∟ ∟ ∟ type | string | 用户(user) 服务商(sp) |
| ∟ ∟ ctime | integer | 创建时间 |
| ∟ ∟ ext_attrs | array[object] | 拓展属性 |
| ∟ ∟ ∟ name | string | 拓展属性名称 |
| ∟ ∟ ∟ value | string | 拓展属性值 |
| ∟ ∟ group_ext_attrs | string | 群聊成员扩展属性 |
| ∟ ∟ ∟ role | string | 成员角色,普通成员:normal,管理员:admin,群主:owner |
| ∟ ∟ ∟ status | string | 成员状态:正常状态:normal,已离职:resigned,已被禁言:banned |
| more | object | 更多的错误信息 |
响应体示例
json
{
"code": 0,
"data": {
"items": [
{
"ctime": 0,
"ext_attrs": [
{
"name": "string",
"value": "string"
}
],
"group_ext_attrs": {
"avatar": {
"avatars": ["string"],
"type": "default"
},
"dept_id": "string",
"owner_id": "string",
"settings": {
"is_disable_all_send": false,
"is_disable_part_send": false,
"is_enable_nickname": true,
"is_external_join_approve": true,
"is_join_approve": false,
"is_owner_admin_at_all": false,
"is_owner_admin_modify": false
}
},
"id": "string",
"chat_id": "string",
"identity": {
"avatar": "string",
"company_id": "string",
"id": "string",
"name": "string",
"type": "string"
}
}
],
"next_page_token": "string"
},
"msg": "success"
}