跳到主要内容

修改超级群消息

修改一条已发送成功的超级群消息。消息类型无法修改。如果改前为文本消息，则传入的新消息内容必须同样为文本消息。

请求方法​

POST： https://数据中心域名/ultragroup/msg/modify.json

频率限制： 每分钟限 100 次

签名规则： 所有服务端 API 请求均需要进行规则校验，详见 API 请求签名。

正文参数​

HTTP 请求正文数据格式为 application/x-www-form-urlencoded，支持以下 HTTP 表单参数：

参数类型必传说明
groupIdString是消息所属的超级群 ID。
busChannelString否消息所属的超级群的会话频道 ID。仅在消息属于超级群默认频道（RCDefault）时可以不传该参数。
fromUserIdString是消息发送者 ID。
msgUIDString是消息唯一标识 ID，可通过全量消息路由功能获取。详见全量消息路由。
contentString是修改后的消息内容，单条消息最大 128k。消息类型无法修改。如果改前为文本消息内容体，则传入的新消息内容体必须同样为文本消息内容体。
  • 内置消息类型：将消息内容体 JSON 对象序列化为 JSON 字符串传入。消息内容 JSON 结构体详见用户内容类消息格式或其他内置消息类型的消息内容格式。

    例如，文本消息内容 JSON 结构体内部包含 content 字段（此为 JSON 结构体内的 key 值，注意区分），则需要将 {"content":"Hello world!"} 序列化后的结果作为此处 content 字段的值。

  • 自定义消息类型（objectName 字段必须指定为自定义消息类型）：如果发送自定义消息，该参数可自定义格式，不限于 JSON。

请求示例​

POST /ultragroup/msg/modify.json HTTP/1.1
Host: api-cn.ronghub.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408710653491
Signature: 45beb7cc7307338a8e711219a47b7cf6a5b000e8
Content-Type: application/x-www-form-urlencoded

groupId=BWSZNmXBD&fromUserId=2191&msgUID=C16R-VBGG-1IE5-SD0C&content=%7B%22content%22%3A%22hello%22%2C%22extra%22%3A%22helloExtra%22%7D&busChannel=channel1

返回结果​

HTTP 响应正文包含具有以下结构的 JSON 对象：

返回值返回类型说明
codeNumber返回码，200 为正常。

返回结果示例​

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{"code":200}
最后于 更新