该接口用于获取指定的日程详情。
请求方式: POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/oa/schedule/get?access_token=ACCESS_TOKEN
请求包体:
{
"schedule_id_list": [
"17c7d2bd9f20d652840f72f59e796AAA"
]
}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
schedule_id_list | 是 | 日程ID列表。一次最多拉取1000条 |
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"schedule_list": [
{
"schedule_id": "17c7d2bd9f20d652840f72f59e796AAA",
"organizer": "userid1",
"attendees": [
{
"userid": "userid2",
"response_status": 1
}
],
"summary": "test_summary",
"description": "test_content",
"reminders": {
"is_remind": 1,
"is_repeat": 1,
"remind_before_event_secs": 3600,
"repeat_type": 7
},
"location": "test_place",
"cal_id": "wcjgewCwAAqeJcPI1d8Pwbjt7nttzAAA",
"start_time": 1571274600,
"end_time": 1571320210,
"status": 1
}
]
}
参数说明:
参数 | 说明 |
---|---|
errcode | 错误码 |
errmsg | 错误码说明 |
schedule_list | 日程列表 |
schedule_id | 日程ID |
organizer | 组织者 |
start_time | 日程开始时间,Unix时间戳 |
end_time | 日程结束时间,Unix时间戳 |
attendees | 日程参与者列表。最多支持2000人 |
userid | 日程参与者ID |
response_status | 日程参与者的接受状态。0 - 未处理1 - 待定2 - 全部接受3 - 仅接受一次4 - 拒绝 |
summary | 日程标题。0 ~ 128 字符。不填会默认显示为“新建事件” |
description | 日程描述。0 ~ 512 字符 |
reminders | 提醒相关信息 |
is_remind | 是否需要提醒。0-否;1-是 |
remind_before_event_secs | 日程开始(start_time)前多少秒提醒,当is_remind为1时有效。例如: 300表示日程开始前5分钟提醒。目前仅支持以下数值:0 - 事件开始时300 - 事件开始前5分钟900 - 事件开始前15分钟3600 - 事件开始前1小时86400 - 事件开始前1天 |
is_repeat | 是否重复日程。0-否;1-是 |
repeat_type | 重复类型,当is_repeat为1时有效。目前支持如下类型: 0 - 每日1 - 每周2 - 每月5 - 每年7 - 工作日 |
location | 日程地址。0 ~ 128 字符 |
cal_id | 日程所属日历ID。如果是在默认日历上,该参数没有值 |
status | 日程状态。0-正常;1-已取消 |
注意,被取消的日程也可以拉取详情,调用者需要检查status