日程接口创建日程

POST

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

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

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

责任人：未设置

该接口用于在日历中创建一个日程。

关于自定义重复的说明：
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时间戳

cal_id

string

可选

日程所属日历ID。该日历必须是access_token所对应应用所创建的日历。注意，这个日历必须是属于组织者(organizer)的日历；如果不填，那么插入到组织者的默认日历上。第三方应用必须指定cal_id 不多于64字节

organizer

string

可选

组织者不多于64字节

attendees

array [object {1}]

可选

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

end_time

integer <int32>

可选

description

string

可选

日程描述不多于512个字符

location

string

可选

日程地址不多于128个字符

agentid

integer <int32>

可选

授权方安装的应用agentid。仅旧的第三方多应用套件需要填此参数

示例

{
  "schedule": {
    "organizer": "userid1",
    "start_time": 1571274600,
    "end_time": 1571320210,
    "attendees": [
      {
        "userid": "userid2"
      }
    ],
    "summary": "需求评审会议",
    "description": "2.0版本需求初步评审",
    "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": "广州国际媒体港10楼1005会议室",
    "cal_id": "wcjgewCwAAqeJcPI1d8Pwbjt7nttzAAA"
  },
  "agentid": 1000014
}

示例代码

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/add?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "schedule": {
        "organizer": "userid1",
        "start_time": 1571274600,
        "end_time": 1571320210,
        "attendees": [
            {
                "userid": "userid2"
            }
        ],
        "summary": "需求评审会议",
        "description": "2.0版本需求初步评审",
        "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": "广州国际媒体港10楼1005会议室",
        "cal_id": "wcjgewCwAAqeJcPI1d8Pwbjt7nttzAAA"
    },
    "agentid": 1000014
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

errmsg

string

必需

schedule_id

string

日程ID

必需

示例

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

修改于 2022-08-30 03:03:37

日历接口删除日历

日程接口更新日程

日程接口 创建日程

请求参数

示例代码

返回响应

日程接口创建日程