钉钉开发文档

DING日程

更新时间: 2019-7-18

创建日程
调用该接口可以将企业员工的待办事项写入到钉钉日历并在钉钉日历中展示。
企业可在应用的权限管理页面申请该接口权限,具体可参考文档

请求方式: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 必须 notification 日程类型:notification-提醒
└ start_time DatetimeVo 必须 开始时间
└└unix_timestamp Number 必须 1512112001000 开始的unix时间戳(单位:毫秒)
└└timezone String 可选 Asia/Shanghai 时区
└ source OpenCalendarSourceVo 必须 显示日程来源
└└title String 可选 招聘 日程来源
└└url String 必须 http://www.dingtalk.
com/page=xxx
点击日程跳转目标地址
└ description String 可选 候选人:很有激情,有互联网经验,有潜力。 备注
└ creator_userid String 必须 04533363830422783 创建者userid
└ uuid String 必须 0baf5616151266393
01253604d6e31
请求的唯一标识, 保证请求唯一性
└ biz_id String 必须 bizId_1580413021_a
bc
业务方自己的主键

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("notification");
OapiCalendarCreateRequest.OpenCalendarSourceVo source = new OapiCalendarCreateRequest.OpenCalendarSourceVo();
source.setTitle("招聘");
source.setUrl("http://www.dingtalk.com/page=xxx");
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
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!