Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
新版服务端API(DingTalk OpenAPI)
  • 历史文档(不推荐)
  • 开发钉钉应用
  • 服务端API
  • 新版服务端API(DingTalk OpenAPI)
  • 生态伙伴API
获取访问凭证通讯录应用市场客户管理服务群考勤待办任务日程钉盘会议专属钉钉合作空间钉工牌数据目录制造业数字化管理师宜搭应用开发文档
获取访问凭证通讯录应用市场客户管理服务群考勤待办任务日程钉盘会议专属钉钉合作空间钉工牌数据目录制造业数字化管理师宜搭应用开发文档
  1. 日程
  • 创建日程
    POST
  • 查询日程列表
    GET
  • 删除日程
    DELETE
  • 修改日程
    PUT
  • 查询单个日程详情
    GET
  • 添加日程参与者
    POST
  • 删除日程参与者
    POST
  • 设置日程响应邀请状态
    POST
  • 获取用户忙闲信息
    POST
  • 查看单个日程的签到详情
    GET
  • 查询日历
    GET
  1. 日程

查询日程列表

GET
http://127.0.0.1/v1.0/calendar/users/{userId}/calendars/{calendarId}/events
最后修改时间:2022-08-30 09:19:21
责任人:未设置

说明#

调用本接口查询一个用户给定时间范围内的日程,支持翻页和增量查询。
服务地址:api.dingtalk.com

权限#

要调用此API,需要以下权限之一。
应用类型是否支持权限API Explorer调试
企业内部应用支持日历应用中日程读权限API Explorer
第三方企业应用暂不支持日历应用中日程读权限暂不支持
第三方个人应用支持日历应用中日程读权限API Explorer

错误码#

HttpCode错误码错误信息说明
400invalidParameterforwardErrorMessage参数异常

请求参数

Path 参数

Query 参数

Header 参数

Body 参数application/json

示例
{}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://127.0.0.1/v1.0/calendar/users//calendars//events' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功
application/json
Body

示例
{
    "nextToken": "string",
    "events": [
        {
            "id": "string",
            "summary": "string",
            "description": "string",
            "start": {
                "date": "string",
                "dateTime": "string",
                "timeZone": "string"
            },
            "end": {
                "date": "string",
                "dateTime": "string",
                "timeZone": "string"
            },
            "isAllDay": true,
            "recurrence": {
                "pattern": {
                    "type": "string",
                    "dayOfMonth": 0,
                    "daysOfWeek": "string",
                    "index": "string",
                    "interval": 0
                },
                "range": {
                    "type": "string",
                    "endDate": "string",
                    "numberOfOccurrences": 0
                }
            },
            "attendees": [
                {
                    "id": "string",
                    "displayName": "string",
                    "responseStatus": "string",
                    "self": true
                }
            ],
            "organizer": {
                "id": "string",
                "displayName": "string",
                "responseStatus": "string",
                "self": true
            },
            "location": {
                "displayName": "string"
            },
            "seriesMasterId": "string",
            "createTime": "string",
            "updateTime": "string",
            "status": "string",
            "onlineMeetingInfo": {
                "type": "string",
                "conferenceId": "string",
                "url": "string",
                "extraInfo": {}
            }
        }
    ],
    "syncToken": "string"
}
修改于 2022-08-30 09:19:21
上一页
创建日程
下一页
删除日程
Built with