钉钉开发文档

DING日程

更新时间: 2018-12-15

创建日程

调用创建日程接口可以将企业员工的待办事项写入到钉钉日历并在钉钉日历中展示,支持任务、会议、审批、普通日程等

该接口仅限企业内部开发调用,企业调用目前在灰度阶段,需要申请权限:
1.申请加入“钉钉ISV沟通组”。
2.在钉钉ISV沟通组-审批流程,提交《特殊权限或能力的申请》。
3.审核完成后2个工作日之内,工作人员会开通权限。

请求方式:POST(HTTPS)
请求地址https://oapi.dingtalk.com/topapi/calendar/create?access_token=ACCESS_TOKEN
参数说明

名称 类型 是否必须 示例值 描述
create_vo OpenCalendarCreateVo 可选 创建日程实体
 summary String 必须 阿里巴巴DING峰会高峰论坛 主题
 reminder OpenCalendarReminderVo 可选 事项开始前提醒
 minutes Number 可选 15 距开始时多久进行提醒(单位:分钟)
 remind_type String 可选 app 提醒类型:app-应用内;
 location String 可选 龙章大厦神龙阁 地点
 receiver_userids String [] 必须 [02665144518540838,4533363830422783] 接收者userid
 end_time DatetimeVo 必须 结束时间
 unix_timestamp Number 必须 1512371201000 结束的unix时间戳(单位:毫秒)
 timezone String 可选 Asia/Shanghai 时区
 calendar_type String 必须 task 日程类型:task-任务;meeting-会议;notification-提醒
 start_time DatetimeVo 必须 开始时间
 unix_timestamp Number 必须 1512112001000 开始的unix时间戳(单位:毫秒)
 timezone String 可选 Asia/Shanghai 时区
 source OpenCalendarSourceVo 可选 显示日程来源
 title String 必须 钉钉HRM 日程来源
 url String 必须 https://dingtalkclient.com/page/ding?id=1580413021 点击日程跳转目标地址
 description String 可选 见证钉钉4.0功能新亮点 备注
 creator_userid String 必须 04533363830422783 创建者userid
 uuid String 必须 0baf561615126639301253604d6e31 请求的唯一标识, 保证请求唯一性
 biz_id String 必须 1580413021 业务方自己的主键

SDK请求示例(JAVA)

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/calendar/create");
OapiCalendarCreateRequest request = new OapiCalendarCreateRequest();
OapiCalendarCreateRequest.OpenCalendarCreateVo creatVo = new OapiCalendarCreateRequest.OpenCalendarCreateVo();
creatVo.setUuid("123456");
creatVo.setBizId("test123");
creatVo.setCreatorUserid("1226682231742708");
creatVo.setSummary("测试日历创建");
creatVo.setReceiverUserids(Arrays.asList("01376814877479"));
OapiCalendarCreateRequest.DatetimeVo start = new OapiCalendarCreateRequest.DatetimeVo();
start.setUnixTimestamp(System.currentTimeMillis()-10000);
creatVo.setStartTime(start);
OapiCalendarCreateRequest.DatetimeVo end = new OapiCalendarCreateRequest.DatetimeVo();
end.setUnixTimestamp(System.currentTimeMillis());
creatVo.setEndTime(end);
creatVo.setCalendarType("task");
OapiCalendarCreateRequest.OpenCalendarSourceVo source = new OapiCalendarCreateRequest.OpenCalendarSourceVo();
source.setTitle("测试日历");
source.setUrl("http://baidu.com");
creatVo.setSource(source);
request.setCreateVo(creatVo);
OapiCalendarCreateResponse response = client.execute(request, accessToken);

返回结果

{
    "result":{
        "dingtalk_calendar_id":"247AF9AF8972B258",
        "invalid_userids":{
            "string":[
                "02665144518540838",
                "04533363830422783"
            ]
        }
    },
    "errcode":0,
    "errmsg":"ok"
}
名称 类型 描述
result CorpCalendarCreateResult result
 dingtalk_calendar_id String dingtalkCalendarId
 invalid_userids String [] invalidUser
errcode Number dingOpenErrcode
errmsg String errorMsg
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!