企业自建应用开发
基础
连接微信
办公
文档
接收外部数据到智能表格
会议
会议统计管理
企业自建应用开发
服务端API
企业数据存档
日程内容存档
获取日程详情
获取日程详情
最后更新:2026/09/09

该接口用于获取存档范围成员的主日历本中指定的日程详情。

请求方式: POST(HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/security/calendar/get_schedule_detail?access_token=ACCESS_TOKEN

请求包体:

{
    "cal_id": "wcjgewCwAAqeJcPI1d8Pwbjt7nttzAAA",
    "schedule_id_list": [
        "17c7d2bd9f20d652840f72f59e796AAA"
    ]
}

参数说明:

参数是否必须说明
cal_id默认日历本 ID,通过「获取默认日历本 ID」接口或回调获取。
schedule_id_list日程ID列表。一次最多拉取10条

返回结果:

{
    "errcode": 0,
    "errmsg": "ok",
    "schedule_list": [{
        "schedule_id": "17c7d2bd9f20d652840f72f59e796AAA",
        "organizer":"organizer1",
        "attendees": [{
            "userid": "userid2",
            "response_status": 1
        }],
        "summary": "test_summary",
        "description": "test_content",
        "reminders": {
            "is_remind": 1,
            "is_repeat": 1,
            "remind_before_event_secs": 3600,
            "remind_time_diffs": [-3600],
            "repeat_type": 7,
            "repeat_until": 1606976813,
            "is_custom_repeat": 1,
            "repeat_interval": 1,
            "repeat_day_of_week": [3, 7],
            "repeat_day_of_month": [10, 21],
            "timezone": 8,
            "exclude_time_list": [{
                "start_time": 1571361000
            }]
        },
        "location": "test_place",
        "cal_id": "wcjgewCwAAqeJcPI1d8Pwbjt7nttzAAA",
        "start_time": 1571274600,
        "end_time": 1571579410,
        "status": 1,
        "meetingroom_id":"xxxx"
    }],
    "meeting_code":"123456789",
    "meeting_link":"https://wecomm.com/znigeot"
}

参数说明:

参数类型说明
errcodeint32返回码
errmsgstring错误码描述
schedule_listobj[]日程列表
schedule_list.schedule_idstring日程ID
schedule_list.organizerstring日程创建者userid 
schedule_list.attendeesobj[]日程参与者列表。
schedule_list.attendees.useridstring日程参与者ID
schedule_list.attendees.response_statusuint32日程参与者的接受状态。
0 - 未处理
1 - 待定
2 - 全部接受
3 - 仅接受一次
4 - 拒绝
schedule_list.summarystring日程标题
schedule_list.descriptionstring日程描述
schedule_list.remindersobj提醒相关信息
schedule_list.reminders.is_remindint32是否需要提醒。0-否;1-是
schedule_list.reminders.is_repeatint32是否重复日程。0-否;1-是
schedule_list.reminders.remind_before_event_secsuint32日程开始(start_time)前多少秒提醒,当is_remind为1时有效。例如: 300表示日程开始前5分钟提醒。目前仅支持以下数值:
0 - 事件开始时
300 - 事件开始前5分钟
900 - 事件开始前15分钟
3600 - 事件开始前1小时
86400 - 事件开始前1天
注意:建议使用 remind_time_diffs 字段,该字段后续将会废弃。
schedule_list.reminders.remind_time_diffsint32[]提醒时间与日程开始时间(start_time)的差值,当is_remind为1时有效。例如:-300表示日程开始前5分钟提醒。
特殊情况:企业微信终端设置的“全天”类型的日程,由于start_time是0点时间戳,提醒如果设置了当天9点,则会出现正数32400。
取值范围:-604800 ~ 86399
schedule_list.reminders.repeat_typeuint32重复类型,当is_repeat为1时有效。目前支持如下类型:
0 - 每日
1 - 每周
2 - 每月
5 - 每年
7 - 工作日
schedule_list.reminders.repeat_untiluint32重复结束时刻,Unix时间戳。不填或填0表示一直重复
schedule_list.reminders.is_custom_repeatuint32是否自定义重复。0-否;1-是
schedule_list.reminders.repeat_intervaluint32重复间隔
仅当指定为自定义重复时有效
该字段随repeat_type不同而含义不同
例如:
repeat_interval指定为2,repeat_type指定为每周重复,那么每2周重复一次;
repeat_interval指定为2,repeat_type指定为每月重复,那么每2月重复一次
schedule_list.reminders.repeat_day_of_weekuint32[]每周周几重复
仅当指定为自定义重复且重复类型为每周时有效
取值范围:1 ~ 7,分别表示周一至周日
schedule_list.reminders.repeat_day_of_monthuint32[]每月哪几天重复
仅当指定为自定义重复且重复类型为每月时有效
取值范围:1 ~ 31,分别表示1~31号
schedule_list.reminders.timezoneuint32时区。UTC偏移量表示(即偏离零时区的小时数),东区为正数,西区为负数。
例如:+8 表示北京时间东八区
默认为北京时间东八区
取值范围:-12 ~ +12
schedule_list.reminders.exclude_time_listobj[]重复日程不包含的日期列表。对重复日程修改/删除特定一天或多天,则原来的日程将会排除对应的日期。
schedule_list.reminders.exclude_time_list.start_timeuint32不包含的日期时间戳。
schedule_list.locationstring日程地址
不多于128个字符
schedule_list.statusuint32日程状态。0-正常;1-已取消
schedule_list.start_timeuint32日程开始时间,Unix时间戳
schedule_list.end_timeuint32日程结束时间,Unix时间戳
schedule_list.is_whole_dayuint32是否为全天日程,0-否;1-是
schedule_list.cal_idstring日程所属日历ID。不多于64字节
schedule_list.meetingroom_idstring日程关联会议室id
meeting_codestring会议号
meeting_linkstring入会链接

注意,被取消的日程也可以拉取详情,调用者需要检查 status

上一篇获取日程列表
下一篇回调通知
    本节内容
服务端API
基础
连接微信
办公
文档
接收外部数据到智能表格
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
JS-SDK
基础
连接微信
办公
消息推送(原“群机器人”)
更新日志