查询日程

适用版本 >=v7.0.2411b.20241128
接口说明：查询日程，当 calendar_id = primary 时, 操作的是主日历下的数据

标签：日程

请求说明

字段	值
请求地址	配置域名+/openapi+`/v7/calendars/{calendar_id}/events/{event_id}`
HTTP 方法	`GET`
接口描述	查询日程，当 calendar_id = primary 时，操作的是主日历下的数据
签名方式	KSO-1（配置域名+/openapi不参与签名）
限频策略	无
权限要求	查询日程信息(应用授权) `kso.calendar_events.read` 查询和管理日程信息(应用授权) `kso.calendar_events.readwrite` 查询日程信息(用户授权) `kso.calendar_events.read` 查询和管理日程信息(用户授权) `kso.calendar_events.readwrite` 使用MCP日程能力(用户授权) `kso.mcp_calendar.readwrite` 使用MCP场景化服务能力(用户授权) `kso.mcp_scenario.readwrite`

请求头 (Headers)

属性名	类型	是否必填	描述	可选值
X-Kso-Id-Type	`string`	否	类型 * internal - 内部 * external - 外部	`internal`, `external`
X-Kso-Date	`string`	是	RFC1123 格式的日期，例: `Wed, 23 Jan 2013 06:43:08 GMT`	-
X-Kso-Authorization	`string`	是	KSO-1 签名值，详见《签名方法》	-
Authorization	`string`	是	授权凭证，格式为：`Bearer {access_token}`	-

路径参数 (Path)

属性名	类型	是否必填	描述	可选值
calendar_id	`string`	是	日历id，可从日历列表、主日历详情获取，或使用primary指代用户的主日历	-
event_id	`string`	是	日程id，可从日程列表获取	-

响应体(Response)

HTTP状态码: 200
响应体格式: application/json

没有可用的数据

响应体示例

json

{
  "data": {
    "calendar_id": "string",
    "description": "string",
    "end_time": {
      "date": "string",
      "datetime": "string"
    },
    "free_busy_status": "busy",
    "id": "string",
    "locations": [
      {
        "name": "string"
      }
    ],
    "online_meeting": {
      "description": "string",
      "join_code": "string",
      "meeting_setting": {
        "auto_recording": "off",
        "host_id": "string",
        "is_allow_attendees_start": true,
        "is_open_lobby": true,
        "join_permission": "anyone",
        "meeting_type": "general",
        "mute_on_join": "off",
        "recording_view_permission": "organizer_only",
        "require_camera_on_join": true
      },
      "provider": "kso",
      "url": "string"
    },
    "organizer": {
      "type": "user",
      "user_id": "string"
    },
    "original_start_time": {
      "date": "string",
      "datetime": "string"
    },
    "recurrence": {
      "by_day": [
        "string"
      ],
      "by_month": [
        0
      ],
      "by_month_day": [
        0
      ],
      "count": 0,
      "exdate": [
        {
          "date": "string",
          "datetime": "string"
        }
      ],
      "freq": "YEARLY",
      "interval": 0,
      "until_date": {
        "date": "string",
        "datetime": "string"
      }
    },
    "recurring_event_id": "string",
    "reminders": [
      {
        "minutes": 0
      }
    ],
    "start_time": {
      "date": "string",
      "datetime": "string"
    },
    "status": "normal",
    "summary": "string",
    "visibility": "default"
  },
  "code": 0,
  "msg": "string"
}