获取日历详情 - 接口文档 - 企业微信开发者中心

开发者中心

首页

教程

接口

社区

工具

企业内部开发

快速入门服务端API 客户端API 附录更新日志联系我们

企业内部开发服务端API 日程管理日历获取日历详情

获取日历详情

最后更新：2023/04/11

该接口用于获取应用在企业内创建的日历信息。

请求方式： POST（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/oa/calendar/get?access_token=ACCESS_TOKEN

请求包体：

{ 
	"cal_id_list": ["wcjgewCwAAqeJcPI1d8Pwbjt7nttzAAA"]
}

参数说明：

参数	是否必须	说明
cal_id_list	是	日历ID列表，调用创建日历接口后获得。一次最多可获取1000条

返回结果：

{
	"errcode": 0,
	"errmsg": "ok",
	"calendar_list": [{
		"cal_id": "wcjgewCwAAqeJcPI1d8Pwbjt7nttzAAA",
		"adminis":[
				"admin1",
				"admin2",
		],
		"summary": "test_summary",
		"color": "#FF3030",
		"description": "test_describe_1",
		"shares": [{
				"userid": "userid2",
				"permission": 1
			},
			{
				"userid": "userid1",
				"permission": 3
			}
		],
		"is_public": 1,
		"public_range": {
			"userids": ["abel", "jack"],
			"partyids": [1232, 34353]
		},
		"is_corp_calendar": 1
	}]
}

参数说明：

参数	说明
errcode	错误码
errmsg	错误码说明
calendar_list	日历列表
cal_id	日历ID
admins	日历的管理员userid列表
summary	日历标题。1 ~ 128 字符
color	日历颜色，RGB颜色编码16进制表示，例如："#0000FF" 表示纯蓝色
description	日历描述。0 ~ 512 字符
is_public	是否公共日历。0-否；1-是
public_range	公开范围。仅当是公共日历时有效
public_range.userids	公开的成员列表范围
public_range.partyids	公开的部门列表范围
is_corp_calendar	是否全员日历。0-否；1-是
shares	日历通知范围成员列表。最多2000人
shares.userid	日历通知范围成员的id
shares.permission	日历通知范围成员权限。 1：可查看 3：仅查看闲忙状态

更新日历

删除日历

本节内容

获取日历详情