延时更新消息 卡片
POST
https://open.feishu.cn/open-apis/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是否填写且是否正确。 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.feishu.cn/open-apis/interactive/v1/card/update' \
--header 'Authorization;' \
--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"
}
请求参数
Header 参数
Authorization
string
必需
默认值:
Bearer {{access_token}}
Content-Type
string
必需
默认值:
application/json; charset=utf-8
Body 参数application/json
返回响应
修改于 2023-01-12 09:48:50