每日钉钉API探索：createDing一键发起DING消息

在企业协作中，及时提醒和任务分发至关重要。今天我们要介绍的是钉钉提供的 createDing 接口，它允许你一键唤起DING消息、任务、日程等创建界面，帮助用户快速发起重要通知或任务提醒。

📌 功能概述

createDing 是一个非常实用的接口，用于调起钉钉客户端的 DING 发送界面 ，用户可以在该界面中填写内容、选择附件、设置提醒方式等。它不直接发送DING，而是唤起客户端界面，让用户进行最终确认和操作。

适用于：

发起紧急通知（DING消息）
创建日程提醒
分配任务给指定人员
附带图片或链接内容

💻 支持平台

平台	版本要求
Android	✅ 6.0.0+
iOS	✅ 6.0.0+
Harmony	✅ 7.0.0+
Mac	❌ 不支持
Windows	❌ 不支持

说明：目前该接口仅支持移动端（包括H5微应用和小程序），不支持桌面端。

📲 应用类型支持

应用类型	是否支持调用
企业内部应用	✅
第三方企业应用	✅
第三方个人应用	✅

🔐 鉴权规则

H5 应用 ：需通过 dd.config 完成鉴权后使用。
小程序应用：无需鉴权，可直接调用。

⚙️ 参数说明

继承通用输入对象，并扩展以下关键参数：

参数名	类型	必填	示例值	描述
`users`	Array	✅	`["03333", "04333"]`	接收DING的用户ID列表。
`text`	String	否	`"钉消息内容"`	DING消息正文内容。
`type`	Number	否	`1`	附件类型： 1：图片 2：链接
`alertType`	Number	否	`1`	提醒方式： 0：电话 1：短信 2：应用内
`alertDate`	Object	否	`{ value: '2015-05-09 08:00', format: 'yyyy-MM-dd HH:mm' }`	提醒时间。
`attachment`	Object	否	`{ images: ['https://xxx.com/example1.png'] }`	附件信息，如图片链接。
`confInfo`	Object	否	日程信息对象	用于创建日程时的配置。
`taskInfo`	Object	否	任务信息对象	用于创建任务时的配置。
`corpId`	String	H5微应用必填	`"ding12345"`	企业CorpID。

📤 返回结果

继承通用输出对象，无扩展字段，调用成功时返回空对象，失败时返回错误信息。

🛠 使用示例代码

复制代码

dd.createDing({
  text: '这是一条DING消息内容',
  type: 1, // 图片附件类型
  users: ['03333', '04333'],
  corpId: 'ding12345', // H5应用必填
  alertType: 1, // 短信提醒
  alertDate: {
    value: '2025-07-18 10:00',
    format: 'yyyy-MM-dd HH:mm'
  },
  attachment: {
    images: ['https://example.com/image1.jpg']
  },
  confInfo: {
    startTime: {
      value: '2025-07-18 10:30',
      format: 'yyyy-MM-dd HH:mm'
    },
    endTime: {
      value: '2025-07-18 11:30',
      format: 'yyyy-MM-dd HH:mm'
    },
    location: '线上会议',
    remindType: 2,
    remindMinutes: 10
  },
  taskInfo: {
    deadlineTime: {
      value: '2025-07-20 18:00',
      format: 'yyyy-MM-dd HH:mm'
    },
    ccUsers: ['100', '101'],
    taskRemind: 60
  },
  success: function () {
    console.log('DING界面已打开');
  },
  fail: function (err) {
    console.error('调用失败:', err);
  },
  complete: function () {
    console.log('操作完成');
  }
});

🎯 典型使用场景

场景	说明
紧急通知	向指定用户发送DING消息并设置短信或电话提醒。
任务分发	调起任务创建界面，指定接收人、截止时间、抄送人等。
日程安排	快速唤起日程界面，预填时间、地点等信息。
带附件通知	附加图片或链接，增强信息表达。

📌 小贴士

该接口不会直接发送DING，而是唤起客户端界面，由用户完成最终操作。
如果你需要服务端自动发送DING ，请使用钉钉的 DING消息接口（非本接口）。
可结合 dd.http 接口调用钉钉服务端接口，实现更复杂的业务逻辑。