选择应用类型
第三方个人应用开发
开发前必读
开发应用
应用管理
服务端API
开发指南
获取访问凭证
钉钉统一授权套件
通讯录管理
日程
概述
权限申请
日程资源
用户访问控制
日程
日程参与者
忙闲
日历
查询日历
订阅公共日历
取消订阅公共日历
创建订阅日历
查询单个订阅日历详情
更新订阅日历
删除订阅日历
签到
常见问题
应用市场
数字化管理师
服务窗
365会员
附录
客户端API
常见问题
历史文档

订阅公共日历新版SDK

更新于 2023-04-06调用本接口,订阅公共日历。

说明

调用本接口前请保证用户拥有该日历的订阅权限。

调用本接口,可订阅公共日历。接口调用成功后,与下图操作实现效果一致。

权限

要调用此API,需要以下权限之一。

应用类型

是否支持

权限

API Explorer调试

企业内部应用支持日历应用中日历写权限API Explorer
第三方企业应用支持日历应用中日历写权限API Explorer
第三方个人应用支持日历应用中日历写权限API Explorer

请求方法

Loading...

Header参数

名称

类型

是否必填

描述

x-acs-dingtalk-access-token

String

调用该接口的访问凭证。

Path参数

名称

类型

是否必填

描述

userId

String

订阅者的unionId。

calendarId

String

日历ID,目前订阅操作仅支持日历类型为subscribed的日历。

说明

订阅日历的创建者或已订阅日历的人员可通过接口获取。

  • 企业内部应用,调用查询日历接口获取id参数值。

  • 第三方企业应用,调用查询日历接口获取id参数值。

  • 第三方个人应用,调用查询日历接口获取id参数值。

示例

请求示例

Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

返回示例

Loading...

错误码

HttpCode

错误码

错误信息

说明

400

permissionDenied

用户不在订阅范围

用户不在订阅范围

400

invalidParameter

forwardErrorMessage

参数异常

400

invalidParameter

calendarId cannot be blank

calendarId不能为空

400

invalidParameter

calendar type invalid

日历类型异常

400

exceedSubscribeLimit

exceed subscribe limit

订阅日历超过上限

这篇文档是否有帮助?
点击纠错