日程接口更新日程

POST

http://127.0.0.1/cgi-bin/oa/schedule/update

第三方应用开发/效率工具/日程/日程接口

最后修改时间：2022-08-30 03:03:37

责任人：未设置

该接口用于在日历中更新指定的日程。

注意，更新操作是覆盖式，而不是增量式
不可更新组织者和日程所属日历ID

关于自定义重复的说明：
is_custom_repeat 如果为0，那么系统会根据 start_time 和 repeat_type 来自动计算下一次重复的时间，例如：

start_time 为本周周三8点整，repeat_type 为每周重复，那么每周三8点整重复；
start_time 为本月3号10点整，repeat_type 为每月重复，那么每月3号10点整重复；

如果 is_custom_repeat 指定为1，那么可以配合 repeat_day_of_week 或 repeat_day_of_month 特别指定周几或几号重复，且可以使用 repeat_interval 指定重复间隔

文档ID: 26903
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93648
https://open.work.weixin.qq.com/api/doc/90001/90143/93703

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

schedule

object

日程信息

可选

summary

string

可选

日程标题。0 ~ 128 字符。不填会默认显示为“新建事件”

reminders

object

提醒相关信息

可选

start_time

integer <int32>

可选

日程开始时间，Unix时间戳

organizer

string

可选

组织者不多于64字节

attendees

array [object {1}]

可选

日程参与者列表。最多支持2000人

end_time

integer <int32>

可选

description

string

可选

日程描述不多于512个字符

location

string

可选

日程地址不多于128个字符

schedule_id

string

可选

日程ID。创建日程时返回的ID

示例

{
  "schedule": {
    "organizer": "userid1",
    "schedule_id": "17c7d2bd9f20d652840f72f59e796AAA",
    "start_time": 1571274600,
    "end_time": 1571320210,
    "attendees": [
      {
        "userid": "userid2"
      }
    ],
    "summary": "test_summary",
    "description": "test_description",
    "reminders": {
      "is_remind": 1,
      "remind_before_event_secs": 3600,
      "is_repeat": 1,
      "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
    },
    "location": "test_place"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://127.0.0.1/cgi-bin/oa/schedule/update?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "schedule": {
        "organizer": "userid1",
        "schedule_id": "17c7d2bd9f20d652840f72f59e796AAA",
        "start_time": 1571274600,
        "end_time": 1571320210,
        "attendees": [
            {
                "userid": "userid2"
            }
        ],
        "summary": "test_summary",
        "description": "test_description",
        "reminders": {
            "is_remind": 1,
            "remind_before_event_secs": 3600,
            "is_repeat": 1,
            "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
        },
        "location": "test_place"
    }
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

errmsg

string

必需

示例

{
  "errcode": 0,
  "errmsg": "string"
}

日程接口创建日程

日程接口获取日程详情