该接口用于获取应用在企业内创建的日历信息。
请求方式: 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:仅查看闲忙状态 |