文档中心 > API类目 > 钉钉API

dingtalk.corp.calendar.create (创建日程)

通过此接口可以把企业员工的待办事项导入到钉钉日历并在钉钉日历中展示, 支持任务, 会议,审批,普通日程等. 该接口处于内部灰度阶段, 申请使用请邮件联系:wusuan.yby@alibaba-inc.com

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

请求参数

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

响应参数

名称	类型	示例值	描述
result	DingOpenResult		result
result CorpCalendarCreateResult result └ dingtalk_calendar_id String 247AF9AF8972B258 dingtalkCalendarId └ invalid_userids String [] 02665144518540838,04533363830422783 invalidUser └ ding_open_errcode Number 50 dingOpenErrcode └ error_msg String -1 errorMsg └ success Boolean false 创建结果

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

DingTalkClient client = new DefaultDingTalkClient("https://eco.taobao.com/router/rest");
CorpCalendarCreateRequest req = new CorpCalendarCreateRequest();
OpenCalendarCreateVo obj1 = new OpenCalendarCreateVo();
obj1.setSummary("阿里巴巴DING峰会高峰论坛");
OpenCalendarReminderVo obj2 = new OpenCalendarReminderVo();
obj2.setMinutes(15L);
obj2.setRemindType("app");
obj1.setReminder(obj2);
obj1.setLocation("龙章大厦神龙阁");
obj1.setReceiverUserids("02665144518540838,4533363830422783");
DatetimeVo obj3 = new DatetimeVo();
obj3.setUnixTimestamp(1512371201000L);
obj3.setTimezone("Asia/Shanghai");
obj1.setEndTime(obj3);
obj1.setCalendarType("task");
DatetimeVo obj4 = new DatetimeVo();
obj4.setUnixTimestamp(1512112001000L);
obj4.setTimezone("Asia/Shanghai");
obj1.setStartTime(obj4);
OpenCalendarSourceVo obj5 = new OpenCalendarSourceVo();
obj5.setTitle("钉钉HRM");
obj5.setUrl("https://dingtalkclient.com/page/ding?id=1580413021");
obj1.setSource(obj5);
obj1.setDescription("见证钉钉4.0功能新亮点");
obj1.setCreatorUserid("04533363830422783");
obj1.setUuid("0baf561615126639301253604d6e31");
obj1.setBizId("1580413021");
req.setCreateVo(obj1);
CorpCalendarCreateResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://eco.taobao.com/router/rest");
CorpCalendarCreateRequest req = new CorpCalendarCreateRequest();
CorpCalendarCreateRequest.OpenCalendarCreateVoDomain obj1 = new CorpCalendarCreateRequest.OpenCalendarCreateVoDomain();
obj1.Summary = "阿里巴巴DING峰会高峰论坛";
CorpCalendarCreateRequest.OpenCalendarReminderVoDomain obj2 = new CorpCalendarCreateRequest.OpenCalendarReminderVoDomain();
obj2.Minutes = 15L;
obj2.RemindType = "app";
obj1.Reminder= obj2;
obj1.Location = "龙章大厦神龙阁";
obj1.ReceiverUserids = "02665144518540838,4533363830422783";
CorpCalendarCreateRequest.DatetimeVoDomain obj3 = new CorpCalendarCreateRequest.DatetimeVoDomain();
obj3.UnixTimestamp = 1512371201000L;
obj3.Timezone = "Asia/Shanghai";
obj1.EndTime= obj3;
obj1.CalendarType = "task";
CorpCalendarCreateRequest.DatetimeVoDomain obj4 = new CorpCalendarCreateRequest.DatetimeVoDomain();
obj4.UnixTimestamp = 1512112001000L;
obj4.Timezone = "Asia/Shanghai";
obj1.StartTime= obj4;
CorpCalendarCreateRequest.OpenCalendarSourceVoDomain obj5 = new CorpCalendarCreateRequest.OpenCalendarSourceVoDomain();
obj5.Title = "钉钉HRM";
obj5.Url = "https://dingtalkclient.com/page/ding?id=1580413021";
obj1.Source= obj5;
obj1.Description = "见证钉钉4.0功能新亮点";
obj1.CreatorUserid = "04533363830422783";
obj1.Uuid = "0baf561615126639301253604d6e31";
obj1.BizId = "1580413021";
req.CreateVo_ = obj1;
CorpCalendarCreateResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);

include "TopSdk.php";
date_default_timezone_set('Asia/Shanghai');

$c = new DingTalkClient(DingTalkConstant::$CALL_TYPE_TOP, DingTalkConstant::$METHOD_POST , DingTalkConstant::$FORMAT_JSON);
$req = new CorpCalendarCreateRequest;
$create_vo = new OpenCalendarCreateVo;
$create_vo->summary="阿里巴巴DING峰会高峰论坛";
$reminder = new OpenCalendarReminderVo;
$reminder->minutes="15";
$reminder->remind_type="app";
$create_vo->reminder = $reminder;
$create_vo->location="龙章大厦神龙阁";
$create_vo->receiver_userids="[02665144518540838,4533363830422783]";
$end_time = new DatetimeVo;
$end_time->unix_timestamp="1512371201000";
$end_time->timezone="Asia/Shanghai";
$create_vo->end_time = $end_time;
$create_vo->calendar_type="task";
$start_time = new DatetimeVo;
$start_time->unix_timestamp="1512112001000";
$start_time->timezone="Asia/Shanghai";
$create_vo->start_time = $start_time;
$source = new OpenCalendarSourceVo;
$source->title="钉钉HRM";
$source->url="https://dingtalkclient.com/page/ding?id=1580413021";
$create_vo->source = $source;
$create_vo->description="见证钉钉4.0功能新亮点";
$create_vo->creator_userid="04533363830422783";
$create_vo->uuid="0baf561615126639301253604d6e31";
$create_vo->biz_id="1580413021";
$req->setCreateVo($create_vo);
$resp = $c->execute($req, $access_token, "https://eco.taobao.com/router/rest");

curl -X POST "https://eco.taobao.com/router/rest" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'format=json' \
-d 'method=dingtalk.corp.calendar.create' \
-d 'partner_id=apidoc' \
-d 'session=f4b79450-42b7-4286-bee3-7ef9c16f027f' \
-d 'timestamp=2025-04-24+15%3A25%3A07' \
-d 'v=2.0' \
-d 'create_vo=null'

# -*- coding: utf-8 -*-
import dingtalk.api

req=dingtalk.api.CorpCalendarCreateRequest("https://eco.taobao.com/router/rest")

req.create_vo=""
try:
	resp= req.getResponse(access_token)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"dingtalk.corp.calendar.create");
add_param(pRequest,"create_vo","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('dingtalk.corp.calendar.create', {
	'create_vo':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

XML示例
JSON示例

<dingtalk_corp_calendar_create_response>
    <result>
        <result>
            <dingtalk_calendar_id>247AF9AF8972B258</dingtalk_calendar_id>
            <invalid_userids>
                <string>02665144518540838</string>
                <string>04533363830422783</string>
            </invalid_userids>
        </result>
        <ding_open_errcode>50</ding_open_errcode>
        <error_msg>-1</error_msg>
        <success>false</success>
    </result>
</dingtalk_corp_calendar_create_response>

{
    "dingtalk_corp_calendar_create_response":{
        "result":{
            "result":{
                "dingtalk_calendar_id":"247AF9AF8972B258",
                "invalid_userids":{
                    "string":[
                        "02665144518540838",
                        "04533363830422783"
                    ]
                }
            },
            "ding_open_errcode":50,
            "error_msg":"-1",
            "success":false
        }
    }
}

异常示例

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

钉钉API

dingtalk.corp.calendar.create (创建日程)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈