延时更新消息卡片
POST
/interactive/v1/card/update
使用场景
1.
2.
message_id）看到的卡片内容。延迟更新使用交互回传事件中的token来指定目标更新的消息，无需额外关注原消息的message_id。服务端处理时，可先立即 return 空串，再在30分钟内调用延迟更新接口更新卡片
错误码
| 错误码 | 说明 | 排查建议 |
|---|---|---|
| 11311 | 卡片格式不符合要求。 | 参照错误message具体内容，卡片构造格式可以参考卡片结构。 |
| 10002 | card参数校验错误，请根据msg信息进行确认。 | 补齐card字段，具体格式可以参考卡片结构。 |
| 100000 | 卡片内容转换后超过100KB。 | 减小卡片体积。 |
| 100030 | 传入body参数不符合json规范。 | 检查传入参数。 |
| 200000 | 该卡片消息已被撤回。 | 该卡片消息已撤回，不支持更新。 |
| 200310 | 更新其他应用发送的卡片。 | 不允许更新其他应用发送的卡片。 |
| 200320 | 非共享卡片的open_ids内容是否正确。 | 检查open_ids是否正确。 |
| 300020 | 更新卡片token格式错误。 | 检查token格式，格式为c-xxxx，可通过卡片交互返回内容获取。 |
| 300030 | 更新卡片token失效。 | token有效期为30分钟，请检查token是否在有效期。 |
| 300040 | 更新卡片token使用超过限制次数。 | token仅能使用3次，请检查token是否超过使用次数。 |
| 300090 | 非共享卡片需填写open_ids字段。 | 检查open_ids是否填写且是否正确。 |
请求参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.feishu.cn/open-apis/interactive/v1/card/update' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"token":"c-515fbxxxx", // POST请求中返回的卡片更新凭证
"card": {
"open_ids":["ou_515fbe9d04838174e2035f8xxxx53d07f"], // 选填字段，指定需要更新消息的用户列表
//更新后的卡片JSON内容，详细结构体在 通用能力 - 消息卡片 中查看
"elements": [
{
"tag": "div",
"text": {
"tag": "plain_text",
"content": "overflow & datePicker 功能测试"
},
"fields": [
{
"is_short": true,
"text": {
"tag": "lark_md",
"content": "**已同意**"
}
}
]
}
]
}
}'响应示例响应示例
{
"code": 0,
"msg": "ok"
}
扫码加入交流群修改于 2025-10-20 10:15:19