日历接口获取日历详情

POST

/cgi-bin/oa/calendar/get

服务端API企业内部开发第三方应用开发

该接口用于获取应用在企业内创建的日历信息。

注: 企业微信需要更新到3.0.2及以上版本
文档ID: 26902
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93647
https://open.work.weixin.qq.com/api/doc/90001/90143/93702

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/oa/calendar/get?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"cal_id_list":["wcjgewCwAAqeJcPI1d8Pwbjt7nttzAAA"]}'

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "calendar_list": [
    {
      "cal_id": "wcjgewCwAAqeJcPI1d8Pwbjt7nttzAAA",
      "adminis": [
        "admin1",
        "admin2"
      ],
      "summary": "test_summary",
      "color": "#FF3030",
      "description": "test_describe_1",
      "shares": [
        {
          "userid": "userid2"
        },
        {
          "userid": "userid1"
        }
      ],
      "is_public": 1,
      "public_range": {
        "userids": [
          "abel",
          "jack"
        ],
        "partyids": [
          1232,
          34353
        ]
      },
      "is_corp_calendar": 1
    }
  ]
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

cal_id_list

array[string]

必需

日历ID列表，调用创建日历接口后获得。一次最多可获取1000条

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

错误码

必需

errmsg

string

错误码说明

必需

calendar_list

array [object {9}]

日历列表

必需

cal_id

string

日历ID

可选

adminis

array[string]

可选

日历的管理员userid列表

summary

string

可选

日历标题。1 ~ 128 字符

color

string

可选

日历颜色，RGB颜色编码16进制表示，例如："#0000FF" 表示纯蓝色

description

string

可选

日历描述。0 ~ 512 字符

array [object {1}]

可选

日历通知范围成员列表。最多2000人

is_public

integer

可选

是否公共日历。0-否；1-是

public_range

object

可选

公开范围。仅当是公共日历时有效

is_corp_calendar

integer

可选

是否全员日历。0-否；1-是

修改于 2022-12-02 07:56:13

日历接口更新日历

日历接口删除日历

日历接口 获取日历详情

请求参数

返回响应

日历接口获取日历详情