- 应用开发平台简介（新版）
- 开发应用
- 服务端 API
- 开发指南
- 身份验证（免登）
- 获取访问凭证
- 通讯录管理
- 上下游组织
- 上下级组织
- 服务窗
- 即时通信IM
- 钉钉客联
- 考勤
- 智能人事
- OA 审批
- 智能填表
- 日程
- 待办任务
- Teambition 项目管理
- 日志
- 签到
- 文档/文件
- 公告
- 钉工牌
- 音视频
- 工作台
- 互动卡片
- 企业文化
- 宜搭应用开发
- 专属开放
- 客户管理（官方CRM）
- 行业开放
- 生态开放
- 应用管理
- 智能硬件
- 附录
- 事件订阅
- 参考
- 常见问题
- 历史文档（不推荐）
- 钉钉云
- 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
- 拉取
修改日程
PUT
/v1.0/calendar/users/{userId}/calendars/{calendarId}/events/{eventId}
企业内部应用第三方个人应用
接口调用量说明**钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。
权限#
| 应用类型 | 是否支持 | 权限 | API Explorer调试 |
|---|---|---|---|
| 企业内部应用 | 支持 | 日历应用中日程写权限 | API Explorer |
| 第三方企业应用 | 支持 | 日历应用中日程写权限 | API Explorer |
| 第三方个人应用 | 支持 | 日历应用中日程写权限 | API Explorer |
错误码#
| HttpCode | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
| 400 | invalidParameter | forwardErrorMessage | 参数异常 |
| 400 | invalidParameter | CalendarId cannot be blank | 日历id不能为空 |
| 400 | invalidParameter | Event must be provided. | 日程不能为空 |
| 400 | invalidParameter | Event id summary cannot be blank | 日程id不能为空 |
| 400 | invalidParameter | Recurrence range numberOfOccurrences must between [1, 99] | numberOfOccurrences需满足区间[1,99] |
| 400 | invalidParameter | Recurrence interval must between [1, 365] | interval需满足区间[1,365] |
| 400 | invalidParameter | Meeting room invalid | 会议室不可用 |
| 400 | idempotencyProcessing | Idempotency processing | 幂等请求处理中 |
| 404 | itemNotFound | forwardErrorMessage | 无法找到指定日程 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://api.dingtalk.com/v1.0/calendar/users//calendars//events/' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{
"summary" : "String",
"id" : "String",
"description" : "String",
"start" : {
"date" : "String",
"dateTime" : "String",
"timeZone" : "String"
},
"end" : {
"date" : "String",
"dateTime" : "String",
"timeZone" : "String"
},
"isAllDay" : Boolean,
"recurrence" : {
"pattern" : {
"type" : "String",
"dayOfMonth" : Integer,
"daysOfWeek" : "String",
"index" : "String",
"interval" : Integer
},
"range" : {
"type" : "String",
"endDate" : "String",
"numberOfOccurrences" : Integer
}
},
"attendees" : [ {
"id" : "String",
"email" : "String",
"isOptional" : Boolean
} ],
"location" : {
"displayName" : "String"
},
"extra" : {
"key" : "String"
},
"reminders" : [ {
"method" : "String",
"minutes" : Integer
} ],
"onlineMeetingInfo" : {
"type" : "String"
},
"richTextDescription" : {
"text" : "String"
},
"uiConfigs" : [ {
"uiName" : "String",
"uiStatus" : "String"
} ]
}'响应示例响应示例
{
"id": "iiiP35sJadba8aBSgjrwPRKgiEiF",
"summary": "some event",
"description": "something about this event",
"start": {
"date": "2020-01-01",
"dateTime": "2020-01-01T10:15:30+08:00",
"timeZone": "Asia/Shanghai"
},
"end": {
"date": "2020-01-01",
"dateTime": "2020-01-01T10:15:30+08:00",
"timeZone": "Asia/Shanghai"
},
"isAllDay": false,
"recurrence": {
"pattern": {
"type": "daily",
"dayOfMonth": 14,
"daysOfWeek": "sunday",
"index": "first",
"interval": 1
},
"range": {
"type": "noEnd",
"endDate": "2020-01-01T10:15:30+08:00",
"numberOfOccurrences": 5
}
},
"attendees": [
{
"id": "iiiP35sJadba8aBSgjrwPRKgiEiF",
"displayName": "jack",
"responseStatus": "accepted",
"self": false,
"isOptional": false
}
],
"organizer": {
"id": "iiiP35sJadba8aBSgjrwPRKgiEiF",
"displayName": "tony",
"responseStatus": "accepted",
"self": false
},
"location": {
"displayName": "room 1-2-3"
},
"reminders": [
{
"method": "dingtalk",
"minutes": "15"
}
],
"createTime": "2020-01-01T10:15:30+08:00",
"updateTime": "2020-01-01T10:15:30+08:00"
}请求参数
Path 参数
userId
必需
calendarId
必需
eventId
日程ID。
Header 参数
x-acs-dingtalk-access-token
必需
Body 参数application/json
summary
string
日程标题。
id
string
日程ID。
description
string
日程描述。
start
object
日程开始时间。
date
string
可选
dateTime
string
可选
timeZone
string
可选
end
object
可选
date
string
可选
dateTime
string
可选
timeZone
string
可选
isAllDay
boolean
是否全天日程。
recurrence
object
日程循环规则。
pattern
object
循环规则。
range
object
循环范围。
attendees
array [object {1}]
日程参与人列表。
id
string
可选
location
object
日程地点。
displayName
string
日程地点的名称。
extra
object
可选
true：不发送false：发送noChatNotification：创建日程时是否向参与人发送单聊卡片，取值：
true：不发送false：发送
reminders
array [object {2}]
可选
method
string
可选
minutes
integer
可选
示例
返回响应
🟢200成功
application/json
Body
id
string
日程id。
summary
string
日程标题。
description
string
日程描述。
start
object
日程开始时间。
date
string
必需
dateTime
string
必需
timeZone
string
必需
end
object
日程结束时间。
date
string
必需
dateTime
string
必需
timeZone
string
必需
isAllDay
boolean
是否全天日程。
recurrence
object
日程循环规则。
pattern
object
循环规则。
range
object
循环范围。
attendees
array [object {5}]
日程参与人列表。
id
string
可选
displayName
string
用户名。
responseStatus
string
回复状态。
self
boolean
可选
isOptional
boolean
可选
organizer
object
日程组织者。
id
string
必需
displayName
string
用户名。
responseStatus
string
回复状态。
self
boolean
必需
location
object
日程地点信息。
displayName
string
日程地点展示名称。
createTime
string
创建时间。
updateTime
string
更新时间。
reminders
array [object {2}]
日程提醒。
method
string
提醒方式。
minutes
string
可选
【钉钉】API开发者 微信交流群
用微信扫右侧二维码，加入【钉钉】API开发者 交流群，互助沟通
扫码加入交流群