public class Card extends Object
| 限定符和类型 | 方法和说明 |
|---|---|
BatchUpdateCardResp |
batchUpdate(BatchUpdateCardReq req)
局部更新卡片实体,更新卡片实体局部内容,包括配置和组件。
|
BatchUpdateCardResp |
batchUpdate(BatchUpdateCardReq req,
RequestOptions reqOptions)
局部更新卡片实体,更新卡片实体局部内容,包括配置和组件。
|
CreateCardResp |
create(CreateCardReq req)
创建卡片实体,基于卡片 JSON 代码或卡片搭建工具搭建的卡片,创建卡片实体。
|
CreateCardResp |
create(CreateCardReq req,
RequestOptions reqOptions)
创建卡片实体,基于卡片 JSON 代码或卡片搭建工具搭建的卡片,创建卡片实体。
|
IdConvertCardResp |
idConvert(IdConvertCardReq req)
转换 ID,将[消息
ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#44c58e1c)(
`message_id` )转换为卡片实体
ID(`card_id`)。
|
IdConvertCardResp |
idConvert(IdConvertCardReq req,
RequestOptions reqOptions)
转换 ID,将[消息
ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#44c58e1c)(
`message_id` )转换为卡片实体
ID(`card_id`)。
|
SettingsCardResp |
settings(SettingsCardReq req)
更新卡片配置,更新指定卡片实体的配置,支持卡片配置 `config` 字段和卡片跳转链接 `card_link` 字段。
|
SettingsCardResp |
settings(SettingsCardReq req,
RequestOptions reqOptions)
更新卡片配置,更新指定卡片实体的配置,支持卡片配置 `config` 字段和卡片跳转链接 `card_link` 字段。
|
UpdateCardResp |
update(UpdateCardReq req)
全量更新卡片实体,传入新的卡片 JSON 代码,覆盖更新指定的卡片实体的所有内容。
|
UpdateCardResp |
update(UpdateCardReq req,
RequestOptions reqOptions)
全量更新卡片实体,传入新的卡片 JSON 代码,覆盖更新指定的卡片实体的所有内容。
|
public Card(Config config)
public BatchUpdateCardResp batchUpdate(BatchUpdateCardReq req, RequestOptions reqOptions) throws Exception
## 使用限制;;- 本接口仅支持[卡片 JSON 2.0 结构](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/card-json-v2-structure)。;- 调用该接口时,不支持将卡片设置为独享卡片模式。即不支持将卡片 JSON 数据中的 `update_multi` 属性设置为 `false`。;- 调用该接口的应用身份(tenant_access_token)需与创建目标卡片实体的应用身份一致。 ;
Exceptionpublic BatchUpdateCardResp batchUpdate(BatchUpdateCardReq req) throws Exception
## 使用限制;;- 本接口仅支持[卡片 JSON 2.0 结构](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/card-json-v2-structure)。;- 调用该接口时,不支持将卡片设置为独享卡片模式。即不支持将卡片 JSON 数据中的 `update_multi` 属性设置为 `false`。;- 调用该接口的应用身份(tenant_access_token)需与创建目标卡片实体的应用身份一致。 ;
Exceptionpublic CreateCardResp create(CreateCardReq req, RequestOptions reqOptions) throws Exception
## 使用限制;;- 本接口仅支持[卡片 JSON 2.0 结构](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/card-json-v2-structure)或卡片搭建工具搭建的[新版卡片](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/feishu-card-cardkit/cardkit-upgraded-version-card-release-notes)。;- 调用该接口时,不支持将卡片设置为独享卡片模式。即不支持将卡片 JSON 数据中的 `update_multi` 属性设置为 `false`。;- 一个卡片实体,仅支持发送一次。;- 卡片实体的有效期为 14 天。即创建卡片实体超出 14 天后,你将无法调用相关接口操作卡片。 ;
官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=cardkit&resource=card&version=v1 ;
Exceptionpublic CreateCardResp create(CreateCardReq req) throws Exception
## 使用限制;;- 本接口仅支持[卡片 JSON 2.0 结构](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/card-json-v2-structure)或卡片搭建工具搭建的[新版卡片](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/feishu-card-cardkit/cardkit-upgraded-version-card-release-notes)。;- 调用该接口时,不支持将卡片设置为独享卡片模式。即不支持将卡片 JSON 数据中的 `update_multi` 属性设置为 `false`。;- 一个卡片实体,仅支持发送一次。;- 卡片实体的有效期为 14 天。即创建卡片实体超出 14 天后,你将无法调用相关接口操作卡片。 ;
官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=cardkit&resource=card&version=v1 ;
Exceptionpublic IdConvertCardResp idConvert(IdConvertCardReq req, RequestOptions reqOptions) throws Exception
本接口已不推荐使用。要基于接口创建卡片、发送卡片,推荐你调用[创建卡片实体](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/cardkit-v1/card/create)接口获取卡片实体 ID,再调用[发送消息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)接口发送卡片。;;## 提示; ;
Exceptionpublic IdConvertCardResp idConvert(IdConvertCardReq req) throws Exception
本接口已不推荐使用。要基于接口创建卡片、发送卡片,推荐你调用[创建卡片实体](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/cardkit-v1/card/create)接口获取卡片实体 ID,再调用[发送消息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)接口发送卡片。;;## 提示; ;
Exceptionpublic SettingsCardResp settings(SettingsCardReq req, RequestOptions reqOptions) throws Exception
## 使用限制;;- 调用该接口时,不支持将卡片设置为独享卡片模式。即不支持将卡片 JSON 数据中的 `update_multi` 属性设置为 `false`。;- 调用该接口的应用身份(tenant_access_token)需与创建目标卡片实体的应用身份一致。 ;
Exceptionpublic SettingsCardResp settings(SettingsCardReq req) throws Exception
## 使用限制;;- 调用该接口时,不支持将卡片设置为独享卡片模式。即不支持将卡片 JSON 数据中的 `update_multi` 属性设置为 `false`。;- 调用该接口的应用身份(tenant_access_token)需与创建目标卡片实体的应用身份一致。 ;
Exceptionpublic UpdateCardResp update(UpdateCardReq req, RequestOptions reqOptions) throws Exception
## 使用限制;- 本接口仅支持[卡片 JSON 2.0 结构](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/card-json-v2-structure)。;- 调用该接口时,不支持将卡片设置为独享卡片模式。即不支持将卡片 JSON 数据中的 `update_multi` 属性设置为 `false`。;- 调用该接口的应用身份(tenant_access_token)需与创建目标卡片实体的应用身份一致。 ;
官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=update&project=cardkit&resource=card&version=v1 ;
Exceptionpublic UpdateCardResp update(UpdateCardReq req) throws Exception
## 使用限制;- 本接口仅支持[卡片 JSON 2.0 结构](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/card-json-v2-structure)。;- 调用该接口时,不支持将卡片设置为独享卡片模式。即不支持将卡片 JSON 数据中的 `update_multi` 属性设置为 `false`。;- 调用该接口的应用身份(tenant_access_token)需与创建目标卡片实体的应用身份一致。 ;
官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=update&project=cardkit&resource=card&version=v1 ;
ExceptionCopyright © 2026. All rights reserved.