- 应用开发平台简介(新版)
- 开发应用
- 服务端 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
- 拉取
查询单个日程详情
GET
/v1.0/calendar/users/{userId}/calendars/{calendarId}/events/{eventId}
企业内部应用第三方个人应用

权限#
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 日历应用中日程读权限 | API Explorer |
第三方企业应用 | 支持 | 日历应用中日程读权限 | API Explorer |
第三方个人应用 | 支持 | 日历应用中日程读权限 | API Explorer |
错误码#
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | invalidParameter | forwardErrorMessage | 参数异常 |
404 | instanceNotExist | instance not exist | 循环日程实例不存在 |
404 | itemNotFound | forwardErrorMessage | 无法找到指定日程 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.dingtalk.com/v1.0/calendar/users//calendars//events/?maxAttendees' \
--header 'x-acs-dingtalk-access-token;'
响应示例响应示例
{
"id": "iiiP35sJxxxxPRKgiEiF",
"summary": "test event",
"description": "something about this event",
"status": "confirmed",
"start": {
"date": "2020-01-01",
"dateTime": "2020-01-01T10:15:30+08:00",
"timeZone": "Asia/Shanghai"
},
"originStart": {
"dateTime": "2023-01-01T00:00:00Z"
},
"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": "monday",
"index": "first",
"interval": 1
},
"range": {
"type": "noEnd",
"endDate": "2020-01-01T10:15:30+08:00",
"numberOfOccurrences": 5
}
},
"attendees": [
{
"id": "iiiP35sJxxxxPRKgiEiF",
"displayName": "jack",
"responseStatus": "accepted",
"self": false,
"isOptional": false
}
],
"organizer": {
"id": "iiiP35sJxxxxPRKgiEiF",
"displayName": "tony",
"responseStatus": "accepted",
"self": false
},
"location": {
"displayName": "room 1-2-3",
"meetingRooms": [
"会议室"
]
},
"seriesMasterId": "cnNTbW1YbxxxxvdlQrQT09",
"createTime": "2020-01-01T10:15:30+08:00",
"updateTime": "2020-01-01T10:15:30+08:00",
"reminders": [
{
"method": "dingtalk",
"minutes": "15"
}
],
"onlineMeetingInfo": {
"type": "dingtalk",
"conferenceId": "5c4df21d-xxxx-a6db402b9f3a",
"url": "dingtalk://dingtalkclient/page/videoxxxxalendar?confId=5c4df21d-xxxx9f3f&calendarId=127xxxx124"
},
"extendedProperties": {
"sharedProperties": {
"sourceOpenCid": "zxcvasdfvb123====",
"belongCorpId": "dingd*****1231231"
}
},
"meetingRooms": [
{
"roomId": "c10315a8b4e740a317813ab6fxxxxxx",
"responseStatus": "accepted",
"displayName": "1号会议室"
}
],
"categories": [
{
"displayName": "单周会"
}
]
}
请求参数
Path 参数
userId
必需
calendarId
必需
eventId
日程id。
Query 参数
maxAttendees
string
可选
Header 参数
x-acs-dingtalk-access-token
必需
返回响应
🟢200成功
application/json
Body
id
string
日程id。
summary
string
日程标题。
description
string
日程描述。
status
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
日程地点名称。
meetingRooms
array[string]
必需
seriesMasterId
string
必需
createTime
string
创建时间。
updateTime
string
更新时间。
onlineMeetingInfo
object
线上会议。
type
string
必需
conferenceId
string
会议ID。
url
string
参会的url地址。
extraInfo
object
其他扩展信息。
originStart
object
必需
dateTime
string
必需
reminders
array [object {2}]
日程提醒
method
string
提醒方式。
minutes
string
可选
extendedProperties
object
日程拓展属性。
sharedProperties
object
共享属性。
meetingRooms
array [object {3}]
会议室。
roomId
string
可选
responseStatus
string
可选
displayName
string
会议室名称。
categories
array [object {1}]
日程类型。
displayName
string
可选

【钉钉】API开发者 微信交流群
用微信扫右侧二维码,加入【钉钉】API开发者 交流群,互助沟通


修改于 2024-01-12 08:00:04