> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.
# 查询日程视图
> 调用本接口可查询某用户在指定时间段内的日程视图列表，可获取日程标题、开始日期、开始时间、结束日期和结束时间等信息。
调用本接口，查询某用户在某段时间内的日程列表，可以获取到日程标题、日程的开始日期、开始时间、结束日期、结束时间等信息。
## 接口调用说明
* 本接口与**查询日程列表**接口的区别在于对循环日程的处理。本接口会根据循环规则展开查询区间内的所有循环日程，但不会实际在数据库中生成对应实例。 例如，有一个从1.1号开始的每日循环日程，查询时已经是1.4号，查询区间为1.1号至1.10号，那么本接口会返回1.1～1.10号的所有循环日程，而[查询日程列表](/zh/open/development/query-an-event-list#)接口是不会返回1.4号之后的日程。
* 可以根据返回的日程对象seriesMasterId是否为空，来判断该日程是否为一个循环日程的实例。
## 请求
### 基本信息
| 字段 | 值 |
| ----------- | ---------------------------------------------------------------------------------------- |
| HTTP URL | `https://api.dingtalk.io/v1.0/calendar/users/{userId}/calendars/{calendarId}/eventsview` |
| HTTP Method | GET |
| 支持的应用类型 | appType-企业内部应用 appType-第三方企业应用 appType-第三方个人应用 |
| 权限要求 | permission-Calendar.Event.Read-日历应用中日程读权限 |
### 请求头
| 名称 | 类型 | 是否必填 | 描述 |
| --------------------------- | ------ | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| x-acs-dingtalk-access-token | String | 是 | 调用该接口的访问凭证，通过以下获取： - 企业内部应用，调用[获取企业内部应用的accessToken](/zh/open/development/obtain-the-access-token-of-an-internal-app#)接口获取。 - 第三方企业应用，调用[获取第三方应用授权企业的accessToken](https://open.dingtalk.com/document/development/obtain-the-access-token-of-the-authorized-enterprise-1#)接口获取。 - 第三方个人应用，调用[获取用户token](/zh/open/development/obtain-user-token#)接口获取。 |
### 路径参数
| 名称 | 类型 | 是否必填 | 描述 |
| ---------- | ------ | ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| userId | String | 是 | 要查询的用户unionId。 - 企业内部应用和第三方企业应用，调用[查询用户详情](/zh/open/development/query-user-details#)接口获取unionid参数值。 - 第三方个人应用，调用[获取用户通讯录个人信息](/zh/open/development/dingtalk-retrieve-user-information#)接口获取unionId参数值。 |
| calendarId | String | 是 | 日程所属的日历ID，调用[查询日历](/zh/open/development/query-a-calendar#)接口查询当前用户日程，使用**primary**关键字，表示当前用户的主日历。 |
### 查询参数
| 名称 | 类型 | 是否必填 | 描述 |
| ------------ | ------- | ---- | --------------------------------------------------------------------------------------------------------------------------- |
| timeMin | String | 否 | 查询日程结束时间 >= TimeMin，格式为ISO-8601的date-time格式。 |
| timeMax | String | 否 | 查询日程开始时间 `< timeMax`，格式为 ISO-8601 的 date-time 格式。 |
| maxResults | Integer | 否 | 最大返回记录数，最大值100，默认值100。 |
| maxAttendees | Integer | 否 | 每个日程的参与者查询个数，默认100，最大100。 如果参会人数超过100人，需要拉取全部参会人请使用[获取日程参与者](/zh/open/development/get-the-participants-of-a-schedule#)接口获取。 |
| nextToken | String | 否 | 分页游标。 如果一个查询条件一次无法全部返回结果，会返回分页token，下次查询带上该token后会返回后续数据，直到分页token为null表示数据已经全部查询完毕。 |
### 请求示例
HTTP
```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
GET /v1.0/calendar/users/iiiP35sJadxxx/calendars/primary/eventsview?timeMin=2022-11-27T00:00:00+08:00&timeMax=2022-11-28T00:00:00+08:00&maxResults=100&maxAttendees=100&nextToken=cnNTbW1xxx HTTP/1.1
Host:api.dingtalk.io
x-acs-dingtalk-access-token:dd43888xxx
Content-Type:application/json
```
Java
```java theme={"theme":{"light":"github-light","dark":"github-dark"}}
// This file is auto-generated, don't edit it. Thanks.
package com.aliyun.sample;
import com.aliyun.tea.*;
public class Sample {
/**
* description :
* 使用 Token 初始化账号Client
* @return Client
*
* @throws Exception
*/
public static com.aliyun.dingtalkcalendar_1_0.Client createClient() throws Exception {
com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config();
config.protocol = "https";
config.regionId = "central";
return new com.aliyun.dingtalkcalendar_1_0.Client(config);
}
public static void main(String[] args_) throws Exception {
java.util.List args = java.util.Arrays.asList(args_);
com.aliyun.dingtalkcalendar_1_0.Client client = Sample.createClient();
com.aliyun.dingtalkcalendar_1_0.models.ListEventsViewHeaders listEventsViewHeaders = new com.aliyun.dingtalkcalendar_1_0.models.ListEventsViewHeaders();
listEventsViewHeaders.xAcsDingtalkAccessToken = "";
com.aliyun.dingtalkcalendar_1_0.models.ListEventsViewRequest listEventsViewRequest = new com.aliyun.dingtalkcalendar_1_0.models.ListEventsViewRequest()
.setTimeMin("2022-11-27T00:00:00+08:00")
.setTimeMax("2022-11-28T00:00:00+08:00")
.setMaxResults(100)
.setMaxAttendees(100)
.setNextToken("cnNTbW1xxx");
try {
client.listEventsViewWithOptions("iiiP35sJadxxx", "primary", listEventsViewRequest, listEventsViewHeaders, new com.aliyun.teautil.models.RuntimeOptions());
} catch (TeaException err) {
if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
// err 中含有 code 和 message 属性，可帮助开发定位问题
}
} catch (Exception _err) {
TeaException err = new TeaException(_err.getMessage(), _err);
if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
// err 中含有 code 和 message 属性，可帮助开发定位问题
}
}
}
}
```
Python
```python theme={"theme":{"light":"github-light","dark":"github-dark"}}
# -*- coding: utf-8 -*-
# This file is auto-generated, don't edit it. Thanks.
import os
import sys
from typing import List
from alibabacloud_dingtalk.calendar_1_0.client import Client as dingtalkcalendar_1_0Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_dingtalk.calendar_1_0 import models as dingtalkcalendar__1__0_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient
class Sample:
def __init__(self):
pass
@staticmethod
def create_client() -> dingtalkcalendar_1_0Client:
"""
使用 Token 初始化账号Client
@return: Client
@throws Exception
"""
config = open_api_models.Config()
config.protocol = 'https'
config.region_id = 'central'
return dingtalkcalendar_1_0Client(config)
@staticmethod
def main(
args: List[str],
) -> None:
client = Sample.create_client()
list_events_view_headers = dingtalkcalendar__1__0_models.ListEventsViewHeaders()
list_events_view_headers.x_acs_dingtalk_access_token = ''
list_events_view_request = dingtalkcalendar__1__0_models.ListEventsViewRequest(
time_min='2022-11-27T00:00:00+08:00',
time_max='2022-11-28T00:00:00+08:00',
max_results=100,
max_attendees=100,
next_token='cnNTbW1xxx'
)
try:
client.list_events_view_with_options('iiiP35sJadxxx', 'primary', list_events_view_request, list_events_view_headers, util_models.RuntimeOptions())
except Exception as err:
if not UtilClient.empty(err.code) and not UtilClient.empty(err.message):
# err 中含有 code 和 message 属性，可帮助开发定位问题
pass
@staticmethod
async def main_async(
args: List[str],
) -> None:
client = Sample.create_client()
list_events_view_headers = dingtalkcalendar__1__0_models.ListEventsViewHeaders()
list_events_view_headers.x_acs_dingtalk_access_token = ''
list_events_view_request = dingtalkcalendar__1__0_models.ListEventsViewRequest(
time_min='2022-11-27T00:00:00+08:00',
time_max='2022-11-28T00:00:00+08:00',
max_results=100,
max_attendees=100,
next_token='cnNTbW1xxx'
)
try:
await client.list_events_view_with_options_async('iiiP35sJadxxx', 'primary', list_events_view_request, list_events_view_headers, util_models.RuntimeOptions())
except Exception as err:
if not UtilClient.empty(err.code) and not UtilClient.empty(err.message):
# err 中含有 code 和 message 属性，可帮助开发定位问题
pass
if __name__ == '__main__':
Sample.main(sys.argv[1:])
```
PHP
```java theme={"theme":{"light":"github-light","dark":"github-dark"}}
protocol = "https";
$config->regionId = "central";
return new Dingtalk($config);
}
/**
* @param string[] $args
* @return void
*/
public static function main($args){
$client = self::createClient();
$listEventsViewHeaders = new ListEventsViewHeaders([]);
$listEventsViewHeaders->xAcsDingtalkAccessToken = "";
$listEventsViewRequest = new ListEventsViewRequest([
"timeMin" => "2022-11-27T00:00:00+08:00",
"timeMax" => "2022-11-28T00:00:00+08:00",
"maxResults" => 100,
"maxAttendees" => 100,
"nextToken" => "cnNTbW1xxx"
]);
try {
$client->listEventsViewWithOptions("iiiP35sJadxxx", "primary", $listEventsViewRequest, $listEventsViewHeaders, new RuntimeOptions([]));
}
catch (Exception $err) {
if (!($err instanceof TeaError)) {
$err = new TeaError([], $err->getMessage(), $err->getCode(), $err);
}
if (!Utils::empty_($err->code) && !Utils::empty_($err->message)) {
// err 中含有 code 和 message 属性，可帮助开发定位问题
}
}
}
}
$path = __DIR__ . \DIRECTORY_SEPARATOR . '..' . \DIRECTORY_SEPARATOR . 'vendor' . \DIRECTORY_SEPARATOR . 'autoload.php';
if (file_exists($path)) {
require_once $path;
}
Sample::main(array_slice($argv, 1));
```
Go
```go theme={"theme":{"light":"github-light","dark":"github-dark"}}
// This file is auto-generated, don't edit it. Thanks.
package main
import (
"encoding/json"
"strings"
"fmt"
"os"
util "github.com/alibabacloud-go/tea-utils/v2/service"
dingtalkcalendar_1_0 "github.com/alibabacloud-go/dingtalk/calendar_1_0"
openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
"github.com/alibabacloud-go/tea/tea"
)
// Description:
//
// 使用 Token 初始化账号Client
//
// @return Client
//
// @throws Exception
func CreateClient () (_result *dingtalkcalendar_1_0.Client, _err error) {
config := &openapi.Config{}
config.Protocol = tea.String("https")
config.RegionId = tea.String("central")
_result = &dingtalkcalendar_1_0.Client{}
_result, _err = dingtalkcalendar_1_0.NewClient(config)
return _result, _err
}
func _main (args []*string) (_err error) {
client, _err := CreateClient()
if _err != nil {
return _err
}
listEventsViewHeaders := &dingtalkcalendar_1_0.ListEventsViewHeaders{}
listEventsViewHeaders.XAcsDingtalkAccessToken = tea.String("")
listEventsViewRequest := &dingtalkcalendar_1_0.ListEventsViewRequest{
TimeMin: tea.String("2022-11-27T00:00:00+08:00"),
TimeMax: tea.String("2022-11-28T00:00:00+08:00"),
MaxResults: tea.Int32(100),
MaxAttendees: tea.Int32(100),
NextToken: tea.String("cnNTbW1xxx"),
}
tryErr := func()(_e error) {
defer func() {
if r := tea.Recover(recover()); r != nil {
_e = r
}
}()
_, _err = client.ListEventsViewWithOptions(tea.String("iiiP35sJadxxx"), tea.String("primary"), listEventsViewRequest, listEventsViewHeaders, &util.RuntimeOptions{})
if _err != nil {
return _err
}
return nil
}()
if tryErr != nil {
var err = &tea.SDKError{}
if _t, ok := tryErr.(*tea.SDKError); ok {
err = _t
} else {
err.Message = tea.String(tryErr.Error())
}
if !tea.BoolValue(util.Empty(err.Code)) && !tea.BoolValue(util.Empty(err.Message)) {
// err 中含有 code 和 message 属性，可帮助开发定位问题
}
}
return _err
}
func main() {
err := _main(tea.StringSlice(os.Args[1:]))
if err != nil {
panic(err)
}
}
```
Node.js
```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
'use strict';
// This file is auto-generated, don't edit it
const Util = require('@alicloud/tea-util');
const dingtalkcalendar_1_0 = require('@alicloud/dingtalk/calendar_1_0');
const OpenApi = require('@alicloud/openapi-client');
const Tea = require('@alicloud/tea-typescript');
class Client {
/**
* 使用 Token 初始化账号Client
* @return Client
* @throws Exception
*/
static createClient() {
let config = new OpenApi.Config({ });
config.protocol = 'https';
config.regionId = 'central';
return new dingtalkcalendar_1_0.default(config);
}
static async main(args) {
let client = Client.createClient();
let listEventsViewHeaders = new dingtalkcalendar_1_0.ListEventsViewHeaders({ });
listEventsViewHeaders.xAcsDingtalkAccessToken = '';
let listEventsViewRequest = new dingtalkcalendar_1_0.ListEventsViewRequest({
timeMin: '2022-11-27T00:00:00+08:00',
timeMax: '2022-11-28T00:00:00+08:00',
maxResults: 100,
maxAttendees: 100,
nextToken: 'cnNTbW1xxx',
});
try {
await client.listEventsViewWithOptions('iiiP35sJadxxx', 'primary', listEventsViewRequest, listEventsViewHeaders, new Util.RuntimeOptions({ }));
} catch (err) {
if (!Util.default.empty(err.code) && !Util.default.empty(err.message)) {
// err 中含有 code 和 message 属性，可帮助开发定位问题
}
}
}
}
exports.Client = Client;
Client.main(process.argv.slice(2));
```
C#
```java theme={"theme":{"light":"github-light","dark":"github-dark"}}
// This file is auto-generated, don't edit it. Thanks.
using System;
using System.Collections;
using System.Collections.Generic;
using System.IO;
using System.Threading.Tasks;
using Tea;
using Tea.Utils;
namespace AlibabaCloud.SDK.Sample
{
public class Sample
{
/// Description:
///
/// 使用 Token 初始化账号Client
///
///
///
/// Client
///
///
/// Exception:
/// Exception
public static AlibabaCloud.SDK.Dingtalkcalendar_1_0.Client CreateClient()
{
AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config();
config.Protocol = "https";
config.RegionId = "central";
return new AlibabaCloud.SDK.Dingtalkcalendar_1_0.Client(config);
}
public static void Main(string[] args)
{
AlibabaCloud.SDK.Dingtalkcalendar_1_0.Client client = CreateClient();
AlibabaCloud.SDK.Dingtalkcalendar_1_0.Models.ListEventsViewHeaders listEventsViewHeaders = new AlibabaCloud.SDK.Dingtalkcalendar_1_0.Models.ListEventsViewHeaders();
listEventsViewHeaders.XAcsDingtalkAccessToken = "";
AlibabaCloud.SDK.Dingtalkcalendar_1_0.Models.ListEventsViewRequest listEventsViewRequest = new AlibabaCloud.SDK.Dingtalkcalendar_1_0.Models.ListEventsViewRequest
{
TimeMin = "2022-11-27T00:00:00+08:00",
TimeMax = "2022-11-28T00:00:00+08:00",
MaxResults = 100,
MaxAttendees = 100,
NextToken = "cnNTbW1xxx",
};
try
{
client.ListEventsViewWithOptions("iiiP35sJadxxx", "primary", listEventsViewRequest, listEventsViewHeaders, new AlibabaCloud.TeaUtil.Models.RuntimeOptions());
}
catch (TeaException err)
{
if (!AlibabaCloud.TeaUtil.Common.Empty(err.Code) && !AlibabaCloud.TeaUtil.Common.Empty(err.Message))
{
// err 中含有 code 和 message 属性，可帮助开发定位问题
}
}
catch (Exception _err)
{
TeaException err = new TeaException(new Dictionary
{
{ "message", _err.Message }
});
if (!AlibabaCloud.TeaUtil.Common.Empty(err.Code) && !AlibabaCloud.TeaUtil.Common.Empty(err.Message))
{
// err 中含有 code 和 message 属性，可帮助开发定位问题
}
}
}
}
}
```
## 响应
### 响应体
| 名称 | 类型 | 描述 |
| ------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| nextToken | String | 翻页token。 |
| events | Array | 日程列表。 |
| id | String | 日程事件ID。 |
| summary | String | 日程标题。 |
| description | String | 日程描述。 |
| start | Object | 日程开始日期。 |
| date | String | 日程开始日期，格式：yyyy-MM-dd。 |
| dateTime | String | 日程开始时间，格式为ISO-8601的date-time格式。 |
| timeZone | String | 日程开始时间所属时区，`tz database name`格式。 |
| originStart | Object | 表示循环序列中最初创建时的开始时间。 对于普通单个日程，不返回此属性。 |
| dateTime | String | 其日期和时间信息以 ISO 8601 格式表示，并且始终采用 UTC。 例如：`2023 年 1 月 1 日午夜 UTC 为 2023-01-01T00:00:00Z`。 |
| end | Object | 日程结束时间。 |
| date | String | 日程结束日期，格式：yyyy-MM-dd。 |
| dateTime | String | 日程结束时间，格式为ISO-8601的date-time格式。 |
| timeZone | String | 日程结束时间所属时区，必须和开始时间所属时区相同，`tz database name`格式。 |
| isAllDay | Boolean | 是否为全天日程。 - **true**：是 - **false**：不是 |
| recurrence | Object | 日程重复规则。 |
| pattern | Object | 重复模式。 |
| type | String | 循环规则类型。 - **daily**：每**interval**天重复 - **weekly**：每**interval**周的第**daysOfWeek**天重复 - **absoluteMonthly**：每**interval**月的第**dayOfMonth**天重复 - **relativeMonthly**：每**interval**月的第**index**周的第**daysOfWeek**天重复 - **absoluteYearly**：每**interval**年重复 |
| dayOfMonth | Integer | 当**type**等于**absoluteMonthly**时，用于指定是每个月的第几天。 |
| daysOfWeek | String | 英文小写单词指定星期几，如果有多个值逗号分割。 |
| index | String | 当**type**=**relativeMonthly**时，用于指定每月第几周。 - **first**：第一周 - **second**：第二周 - **third**：第三周 - **fourth**：第四周 - **last**：最后一周 |
| interval | Integer | 循环间隔，根据**type**不同单位不同。例如当**type**等于**daily**时表示间隔N天，**type**等于**absoluteYearly**则表示间隔N年。 |
| firstDayOfWeek | String | 一周起始日，可取值包括：sunday、monday、tuesday、wednesday、thursday、friday、saturday。 默认值为“sunday”。 |
| range | Object | 重复范围。 |
| type | String | 循环范围类型。 - **noEnd**：永不结束 - **endDate**：循环至指定日期结束 - **numbered**：循环指定次数后结束 |
| endDate | String | 循环结束日期。 |
| numberOfOccurrences | Integer | 重复次数。 |
| attendees | Array | 日程参与人。 |
| id | String | 用户unionId。 |
| displayName | String | 用户名。 |
| responseStatus | String | 回复状态。 |
| self | Boolean | 是否是当前登录用户。 - **true**：是 - **false**：不是 |
| isOptional | Boolean | 是否为可选参与人。 - **true**：是 - **false**：不是 |
| organizer | Object | 日程组织人。 |
| id | String | 用户unionId。 |
| displayName | String | 用户名。 |
| responseStatus | String | 回复状态。 |
| self | Boolean | 是否是当前登录用户。 - **true**：是 - **false**：不是 |
| location | Object | 日程地点。 |
| displayName | String | 展示名称。 |
| meetingRooms | Array of String | 会议室。 |
| seriesMasterId | String | 重复日程的主日程id，非重复日程为空。 |
| createTime | String | 创建时间。 |
| updateTime | String | 更新时间。 |
| status | String | 日程状态。 |
| extendedProperties | Object | 日程扩展属性。 |
| sharedProperties | Object | 共享属性。 |
| sourceOpenCid | String | 当日程是由某个群内发起的时候，该字段表示日程发起的来源群。 |
| belongCorpId | String | 日程归属企业的corpId |
| privateProperties | Object | 私有特性。 |
| dingtalkDetailUrl | String | 详情地址。 |
| onlineMeetingInfo | Object | 线上会议。 |
| type | String | 线上会议类型，目前支持： - **dingtalk**：钉钉视频会议 |
| conferenceId | String | 会议ID。 |
| url | String | 参会的URL地址。 |
| extraInfo | Map | 其他扩展信息。 |
| categories | Array | 日程类型。 |
| displayName | String | 日程类型名称。 |
| richTextDescription | Object | 富文本描述。 |
| text | String | 富文本描述内容。 |
| meetingRooms | Array | 会议室。 |
| roomId | String | 会议室roomId。 |
| responseStatus | String | 会议室响应状态。 - **accepted** : 接受 - **tentative**: 审批中 - **declined** : 审批未通过 |
| displayName | String | 会议室名称。 |
### 响应体示例
```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
Content-Type:application/json
{
"nextToken" : "cnNTbWxxx",
"events" : [ {
"id" : "cnNTbxxx",
"summary" : "test event",
"description" : "something about this event",
"start" : {
"date" : "2020-01-01",
"dateTime" : "2020-01-01T10:15:30+08:00",
"timeZone" : "Asia/Shanghai"
},
"originStart" : {
"dateTime" : "2023-01-01T00:00:00Z"
},
"end" : {
"date" : "2020-01-01",
"dateTime" : "2020-01-01T10:15:30+08:00",
"timeZone" : "Asia/Shanghai"
},
"isAllDay" : false,
"recurrence" : {
"pattern" : {
"type" : "daily",
"dayOfMonth" : 14,
"daysOfWeek" : "sunday",
"index" : "first",
"interval" : 1,
"firstDayOfWeek" : "monday"
},
"range" : {
"type" : "noEnd",
"endDate" : "2020-01-01T10:15:30+08:00",
"numberOfOccurrences" : 5
}
},
"attendees" : [ {
"id" : "iiiP35xxx",
"displayName" : "tony",
"responseStatus" : "accepted",
"self" : false,
"isOptional" : false
} ],
"organizer" : {
"id" : "iiiP35xxx",
"displayName" : "jack",
"responseStatus" : "accepted",
"self" : false
},
"location" : {
"displayName" : "room 1-2-3",
"meetingRooms" : [ "会议室" ]
},
"seriesMasterId" : "cnNTbxxx",
"createTime" : "2020-01-01T10:15:30+08:00",
"updateTime" : "2020-01-01T10:15:30+08:00",
"status" : "confirmed",
"extendedProperties" : {
"sharedProperties" : {
"sourceOpenCid" : "zxcvasdfa123===",
"belongCorpId" : "dingd8*****1231"
},
"privateProperties" : {
"dingtalkDetailUrl" : "https://example.com"
}
},
"onlineMeetingInfo" : {
"type" : "dingtalk",
"conferenceId" : "5c4df2xxx",
"url" : "dingtalk://dingtalkclient/page/xxx?confId=xxx&calendarId=xxx"
},
"categories" : [ {
"displayName" : "单周会"
} ],
"richTextDescription" : {
"text" : ""
},
"meetingRooms" : [ {
"roomId" : "c10315a8b4e740a317813ab6fxxxxxx",
"responseStatus" : "accepted",
"displayName" : "1号会议室"
} ]
} ]
}
```
### 错误码
若调用该接口报错，可根据错误信息在[全局错误码](/zh/open/development/server-api-error-codes-1)文档中查找解决方案。
| HttpCode | 错误码 | 错误信息 | 说明 |
| -------- | ---------------- | ------------------- | ---- |
| 400 | invalidParameter | forwardErrorMessage | 参数异常 |