更新群聊信息
用于更新应用机器人所在群聊的信息。
请求说明
| 请求地址 | 配置域名+/o/woa/api/v1/developer/app/chats/ |
|---|---|
| 请求方法 | PUT |
| 签名方式 | wps-4 |
| 支持应用类型 | 企业自建应用、第三方企业应用 |
| 权限要求 | 管理会话及会话成员信息(kso.im.chat.manage) |
请求头
| Header 名称 | 是否必填 | 说明 |
|---|---|---|
| Content-Type | 是 | 目前固定为:application/json |
| Wps-Docs-Date | 是 | 取当前时间, 示例: Wed, 23 Jan 2013 06:43:08 GMT |
| Wps-Docs-Authorization | 是 | 计算方法参考签名说明 |
| Authorization | 是 | 授权token,格式:Bearer ${access_token},${access_token}需替换为从授权接口获取的access_token值 |
路径参数(Path)
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| chatid | integer | 是 | 群聊会话 id |
请求体(Body)
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| name | string | 否 | 群聊名称 |
| owner | int | 否 | 群主 id(不支持机器人成为群主) |
| avatar | string | 否 | 群聊头像 store_key |
| join_approve | boolean | 否 | 是否开启【群主所属企业的人员进群需审核】 |
| change_info_constraint | boolean | 否 | 是否开启【仅群主和管理员可修改群信息】 |
| mention_all_disable | boolean | 否 | 是否开启【仅群主和管理员可@所有人】 |
| enable_nickname | boolean | 否 | 是否开启【群昵称优先展示】 |
请求地址示例
http
[PUT] 配置域名+/o/woa/api/v1/developer/app/chats/{chatid}请求体示例
json
{
"name": "string",
"owner": 123,
"join_approve": true,
"change_info_constraint": true,
"mention_all_disable": true,
"enable_nickname": true,
"avatar": "string"
}响应体
| 名称 | 类型 | 说明 |
|---|---|---|
| result | integer | 状态码,非 0 表示失败,参照《状态码说明》 |
响应体示例
json
{
"result": 0
}