更新已发送的卡片消息
PUT/api/open/v2/bot/messages/:messageId/card
原地更新一条本应用发出的卡片消息(msgType=card,direction=OUTBOUND),无需重发新消息。
所需 Scope:bot.message.send。
请求体 card 的校验规则与发送卡片时完全相同(见卡片消息)。version 为可选的乐观锁版本号:
内联卡片初始版本为 1,用模板发送时初始版本为模板当时的版本号,每次成功更新后 +1;带了 version
且与当前版本不符时更新被拒绝。版本冲突返回 500 + 500000,且 message 是通用的「服务内部错误,请稍后重试」,
无法与平台内部错误区分,请勿据此直接向用户报系统故障。
目标不是本应用发出的消息时返回 403 + 400008「消息未投递给此应用」;目标是文本等非卡片消息时返回 400 + 400006「卡片消息不存在」。
Request
Responses
- 200
更新结果;value.clientMessageId 恒为 null、duplicate 恒为 false