- 应用开发平台简介（新版）
- 历史文档（不推荐）
- 钉钉云
- HTTP回调
- 审批待办
- 旧版宜搭API参考
- 通讯录管理
- 钉钉红包
- 身份验证（免登）
- 花名册
- 行业连接
- 日程
- 开发前必读
- 开发钉钉应用
- H5微应用
- 服务端API
- 通用能力
- 常见问题
- 新版服务端API（DingTalk OpenAPI）
- 生态伙伴API
- 小程序
- 钉钉小程序介绍
- 小程序开发工具
- 小程序运行/更新机制
- 框架
- 基础组件
- 小程序JSAPI
- JSAPI总览
- 免登授权码
- 地图
- 创建地图对象MapContex
- MapContext
- MapContext 概览
- 计算地图路径(calculateDistance)
- 添加/删除/更新指定标记(changeMarkers)
- 清除步行导航路线(clearRoute)
- 设置所有手势是否可用(gestureEnable)
- 获取当前地图中心位置(getCenterLocation)
- 获取地图属性(getMapProperties)
- 获取地图整体的视野范围(getRegion)
- 移动视野到定位点(moveToLocation)
- 规划默认步行路线(showRoute)
- 设置指南针是否可见(showsCompass)
- 设置比例尺控件是否可见(showsScale)
- 指定标记进行动画(smoothMoveMarker)
- 轨迹动画(smoothMovePolyline)
- 平移点标记(translateMarker)
- 增量更新地图(updateComponents)
- 点标记（Marker）图鉴
- 开放接口
- 基础
- 更新管理小程序
- 网络
- 多媒体
- 界面
- 显示模式
- 导航栏
- TabBar
- 交互反馈
- 离开页面二次确认
- 下拉刷新
- 选择日期
- 动画
- 画布
- 创建canvas
- CanvasContext
- CanvasContext概览
- 把画布内容导出成图片(toTempFilePath)
- 文本对齐方式(setTextAlign)
- 文本基线（setTextBaseline）
- 设置填充色(setFillStyle)
- 设置边框颜色(setStrokeStyle)
- 设置阴影样式(setShadow)
- 创建线性的渐变色(createLinearGradient)
- 创建圆形的渐变色(createCircularGradient)
- 创建渐变点(addColorStop)
- 设置线条宽度(setLineWidth)
- 设置线条的端点样式(setLineCap)
- 设置线条的交点样式(setLineJoin)
- 设置最大斜接长度(setMiterLimit)
- 创建矩形(rect)
- 填充矩形(fillRect)
- 画一个矩形(strokeRect)
- 清除画布上矩形区域内的内容(clearRect)
- 填充内容(fill)
- 画出当前路径的边框(stroke)
- 创建路径(beginPath)
- 关闭一个路径(closePath)
- 移动路径(moveTo)
- 增加一个新点(lineTo)
- 画一条弧线(arc)
- 创建三次方贝塞尔曲线路径(bezierCurveTo)
- 设置为剪切路径(clip)
- 创建二次贝塞尔曲线路径(quadraticCurveTo)
- 缩放(scale)
- 顺时针旋转(rotate)
- 变换原点坐标(translate)
- 设置字体大小(setFontSize)
- 绘制被填充的文本(fillText)
- 绘制图像(drawImage)
- 设置全局画笔透明度(setGlobalAlpha)
- 保存当前绘图上下文(save)
- 恢复绘图上下文(restore)
- 将描述画到画布中(draw)
- 获取canvas区域隐含的像素数据(getImageData)
- 将像素数据绘制到画布(putImageData)
- 键盘
- 滚动
- 节点查询
- 位置
- 缓存
- 设备
- 拉群11
- 拉取
- 开发应用
- 服务端 API
- 开发指南
- 身份验证（免登）
- 获取访问凭证
- 通讯录管理
- 上下游组织
- 上下级组织
- 服务窗
- 即时通信IM
- 钉钉客联
- 考勤
- 智能人事
- OA 审批
- 智能填表
- 日程
- 待办任务
- Teambition 项目管理
- 互动卡片
- 企业文化
- 日志
- 签到
- 文档/文件
- 公告
- 钉工牌
- 音视频
- 工作台
- 宜搭应用开发
- 专属开放
- 客户管理（官方CRM）
- 行业开放
- 生态开放
- 应用管理
- 智能硬件
- 附录
- 事件订阅
- 参考
- 常见问题
创建卡片
POST
/v1.0/card/instances
接口功能介绍#
权限#
| 应用类型 | 是否支持 | 权限 | API Explorer调试 |
|---|---|---|---|
| 企业内部应用 | 支持 | 互动卡片实例写权限 | API Explorer |
| 第三方企业应用 | 支持 | 互动卡片实例写权限 | API Explorer |
| 第三方个人应用 | 暂不支持 | 互动卡片实例写权限 | 暂不支持 |
错误码#
| HttpCode | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
| 400 | param.empty | param.empty | 入参为空 |
| 400 | param.cardTemplateIdEmpty | param.cardTemplateIdEmpty | 卡片模版 Id 为空 |
| 400 | param.outTrackIdEmpty | param.outTrackIdEmpty | 业务标识 outTrackId 为空 |
| 400 | param.userIdEmpty | param.userIdEmpty | 用户 userId 为空 |
| 400 | param.cardPublicDataEmpty | param.cardPublicDataEmpty | 卡片公共数据为空 |
| 400 | param.userIdNotExist | param.userIdNotExist | 用户 userId 不存在 |
| 400 | param.dynamicDataMappingEmpty | param.dynamicDataMappingEmpty | 动态数据源数据映射为空 |
| 400 | param.dynamicSourceIdEmpty | param.dynamicSourceIdEmpty | 动态数据源配置 ID 为空 |
| 400 | param.dynamicDataPullConfigEmpty | param.dynamicDataPullConfigEmpty | 动态数据源拉取配置为空 |
| 400 | param.dynamicDataPullIntervalInvalid | param.dynamicDataPullIntervalInvalid | 动态数据源拉取间隔时间为空或非法 |
| 400 | param.dynamicDataPullIntervalTimeUnitInvalid | param.dynamicDataPullIntervalTimeUnitInvalid | 动态数据源拉取间隔时间单位为空或非法 |
| 400 | param.dynamicDataSourcePullStrategyEmpty | param.dynamicDataSourcePullStrategyEmpty | 动态数据源拉取策略为空 |
| 400 | param.dynamicDataMappingPathEmpty | param.dynamicDataMappingPathEmpty | 动态数据源数据映射路径为空 |
| 400 | param.dynamicDataValueTypeEmpty | param.dynamicDataValueTypeEmpty | 动态数据源数据类型为空 |
| 400 | param.contentUnsafe | param.contentUnsafe | 卡片数据不能通过安全审查 |
| 400 | param.openSpaceModelInvalid | param.openSpaceModelInvalid | 错误的场域属性模型 |
| 400 | param.cardNotExist | param.cardNotExist | 卡片不存在 |
| 400 | param.invalid | param.invalid | 存在非法参数 |
| 400 | param.cardAlreadyExist | param.cardAlreadyExist | 卡片已经存在 |
| 400 | param.templateNotExist | param.templateNotExist | 模板不存在 |
| 400 | param.templateUnpublished | param.templateUnpublished | 模板未发布 |
| 500 | system.busy | system.busy | 系统繁忙 |
请求参数
Header 参数
Body 参数application/json
示例
{
"userId" : "String",
"cardTemplateId" : "String",
"outTrackId" : "String",
"callbackRouteKey" : "String",
"cardData" : {
"cardParamMap" : {
"key" : "String"
}
},
"privateData" : {
"key" : {
"cardParamMap" : {
"key" : "String"
}
}
},
"openDynamicDataConfig" : {
"dynamicDataSourceConfigs" : [ {
"dynamicDataSourceId" : "String",
"constParams" : {
"key" : "String"
},
"pullConfig" : {
"pullStrategy" : "String",
"interval" : Integer,
"timeUnit" : "String"
}
} ]
},
"imGroupOpenSpaceModel" : {
"supportForward" : Boolean,
"lastMessageI18n" : {
"key" : "String"
},
"searchSupport" : {
"searchIcon" : "String",
"searchTypeName" : "String",
"searchDesc" : "String"
},
"notification" : {
"alertContent" : "String",
"notificationOff" : Boolean
}
},
"imRobotOpenSpaceModel" : {
"supportForward" : Boolean,
"lastMessageI18n" : {
"key" : "String"
},
"searchSupport" : {
"searchIcon" : "String",
"searchTypeName" : "String",
"searchDesc" : "String"
},
"notification" : {
"alertContent" : "String",
"notificationOff" : Boolean
}
},
"coFeedOpenSpaceModel" : {
"title" : "String"
},
"topOpenSpaceModel" : {
"spaceType" : "String"
},
"userIdType" : Integer
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1.0/card/instances' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{
"userId" : "String",
"cardTemplateId" : "String",
"outTrackId" : "String",
"callbackRouteKey" : "String",
"cardData" : {
"cardParamMap" : {
"key" : "String"
}
},
"privateData" : {
"key" : {
"cardParamMap" : {
"key" : "String"
}
}
},
"openDynamicDataConfig" : {
"dynamicDataSourceConfigs" : [ {
"dynamicDataSourceId" : "String",
"constParams" : {
"key" : "String"
},
"pullConfig" : {
"pullStrategy" : "String",
"interval" : Integer,
"timeUnit" : "String"
}
} ]
},
"imGroupOpenSpaceModel" : {
"supportForward" : Boolean,
"lastMessageI18n" : {
"key" : "String"
},
"searchSupport" : {
"searchIcon" : "String",
"searchTypeName" : "String",
"searchDesc" : "String"
},
"notification" : {
"alertContent" : "String",
"notificationOff" : Boolean
}
},
"imRobotOpenSpaceModel" : {
"supportForward" : Boolean,
"lastMessageI18n" : {
"key" : "String"
},
"searchSupport" : {
"searchIcon" : "String",
"searchTypeName" : "String",
"searchDesc" : "String"
},
"notification" : {
"alertContent" : "String",
"notificationOff" : Boolean
}
},
"coFeedOpenSpaceModel" : {
"title" : "String"
},
"topOpenSpaceModel" : {
"spaceType" : "String"
},
"userIdType" : Integer
}'返回响应
🟢200成功
application/json
Body
示例
{
"success": true,
"result": "string"
}修改于 2025-09-08 06:28:05