# Lark卡片资源概述
Lark卡片是应用的一种能力，包括构建卡片内容所需的组件和发送卡片所需的能力。Lark开放平台针对Lark卡片提供了一系列 OpenAPI，使用这些 OpenAPI 你可以在卡片和组件维度，局部或流式更新卡片。

## 典型案例

开放平台提供了包含Lark卡片的案例，详情可参见：
- [智能审批管办一体，助力企业效能提升](https://open.larksuite.com/solutions/detail/automation)
- [Lark Base 与 PowerBI 的数据同步解决方案](https://open.larksuite.com/solutions/detail/ticke)

## 接入流程

卡片 API 的基本接入流程如下图所示，如需了解详细的 API 接入流程，参见[流程概述](https://open.larksuite.com/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)。

![](//sf16-sg.larksuitecdn.com/obj/open-platform-opendoc-sg/7e2c712313cbc2da9b298804cbcf94e2_MwxGtG3AQH.png?height=214&lazyload=true&maxWidth=900&width=2276)

## 开发指南

- 前往[消息卡片概述](https://open.larksuite.com/document/ukTMukTMukTM/uczM3QjL3MzN04yNzcDN)，了解如何搭建卡片、发送卡片和更新卡片。
- 参考[流式更新卡片](https://open.larksuite.com/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/streaming-updates-openapi-overview)，了解如何调用卡片接口实现文本流式等能力。

## 资源介绍

Lark卡片 OpenAPI 中，以卡片和组件资源为中心开放接口，支持创建、更新卡片。

资源 | 描述
---|---
卡片 | Lark卡片能将结构化的内容以卡片形式嵌入至聊天消息、群置顶消息、链接预览等Lark协作场景中，提升信息传递效率。了解更多参见[消息卡片概述](https://open.larksuite.com/document/ukTMukTMukTM/uczM3QjL3MzN04yNzcDN)。通过卡片实体 API，你可从卡片维度创建卡片、更新卡片。
组件 | Lark卡片中的组件可分为容器类、展示类和交互类组件。了解更多参见[组件概述](https://open.larksuite.com/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/card-components/component-overview)。通过组件 API，你可以在一张卡片中新增、修改组件。

## 方法列表

以下提供创建和更新卡片的 API 列表。你可通过[创建卡片实体](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/cardkit-v1/card/create)接口创建卡片，再调用[发送消息](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)接口通过卡片 ID 发送卡片。之后使用其它接口局部更新卡片。
**注意事项**：- 下表中 **商店** 是指商店应用，**自建** 是指企业自建应用。应用类型说明参见[应用类型简介](https://open.larksuite.com/document/home/app-types-introduction/overview)。
-  下列接口仅支持[卡片 JSON 2.0 结构](https://open.larksuite.com/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/card-json-v2-structure)。

### 卡片级

<b>方法 (API) | <b>权限要求（满足任一） | <b>访问凭证 | <b>商店 | <b>自建
---|---|---|---|---
`POST`[创建卡片实体](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/cardkit-v1/card/create) open-apis/cardkit/v1/cards | 创建与更新卡片(cardkit:card:write) | `tenant_access_token` | **✓** | **✓**
`PUT` [全量更新卡片实体](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/cardkit-v1/card/update) /open-apis/cardkit/v1/cards/:card_id | 创建与更新卡片(cardkit:card:write) | `tenant_access_token` | **✓** | **✓**
`PATCH` [更新卡片配置](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/cardkit-v1/card/settings) /open-apis/cardkit/v1/cards/:card_id/settings | 创建与更新卡片(cardkit:card:write) | `tenant_access_token` | **✓** | **✓**
`POST` [批量更新卡片实体](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/cardkit-v1/card/batch_update) /open-apis/cardkit/v1/cards/:card_id/batch_update | 创建与更新卡片(cardkit:card:write) | `tenant_access_token` | **✓** | **✓**

### 组件级

<b>方法 (API) | <b>权限要求（满足任一） | <b>访问凭证 | <b>商店 | <b>自建
---|---|---|---|---
`POST`[新增组件](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/cardkit-v1/card-element/create) /open-apis/cardkit/v1/cards/:card_id/elements | 创建与更新卡片(cardkit:card:write) | `tenant_access_token` | **✓** | **✓**
`PUT` [更新组件](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/cardkit-v1/card-element/update) /open-apis/cardkit/v1/cards/:card_id/elements/:element_id | 创建与更新卡片(cardkit:card:write) | `tenant_access_token` | **✓** | **✓**
`PATCH` [更新组件属性](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/cardkit-v1/card-element/patch) /open-apis/cardkit/v1/cards/:card_id/elements/:element_id | 创建与更新卡片(cardkit:card:write) | `tenant_access_token` | **✓** | **✓**
`PUT` [流式更新文本](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/cardkit-v1/card-element/content) /open-apis/cardkit/v1/cards/:card_id/elements/:element_id/content | 创建与更新卡片(cardkit:card:write) | `tenant_access_token` | **✓** | **✓**
`DELETE` [删除组件](https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/cardkit-v1/card-element/delete) /open-apis/cardkit/v1/cards/:card_id/elements/:element_id | 创建与更新卡片(cardkit:card:write) | `tenant_access_token` | **✓** | **✓**

