zgene
6bed393c12
Backend Tests / backend-unit-test (push) Has been cancelled
Backend Tests / benchmark-test (push) Has been cancelled
CI@main / Node.js v22 (ubuntu-latest) (push) Has been cancelled
Thrift Syntax Validation / validate-thrift (push) Has been cancelled
License Check / License Check (push) Has been cancelled
480 lines
19 KiB
YAML
480 lines
19 KiB
YAML
info:
|
|
description: 在飞书上日历上创建日程、更新日程、删除日程、查询日程信息
|
|
title: 飞书日历
|
|
version: v1
|
|
openapi: 3.0.1
|
|
paths:
|
|
/calendar/create_event:
|
|
post:
|
|
operationId: create_event
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
auto_record:
|
|
description: 是否开启自动录制，true：开启，会议开始后自动录制；false：不开启
|
|
type: boolean
|
|
description:
|
|
description: 日程描述
|
|
type: string
|
|
end_time:
|
|
description: 日程结束时间，格式：2006-01-02 15:04:05
|
|
type: string
|
|
need_notification:
|
|
description: 更新日程时是否发送bot消息，true：发送，false：不发送
|
|
type: boolean
|
|
start_time:
|
|
description: 日程开始时间，格式：2006-01-02 15:04:05
|
|
type: string
|
|
summary:
|
|
description: 日程标题，若不填则日程标题显示 (无主题)
|
|
type: string
|
|
required:
|
|
- start_time
|
|
- end_time
|
|
type: object
|
|
responses:
|
|
"200":
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
code:
|
|
description: 错误码，非 0 表示错误
|
|
type: number
|
|
data:
|
|
description: 返回数据
|
|
properties:
|
|
appLink:
|
|
description: 日程的 app_link，跳转到具体的某个日程
|
|
type: string
|
|
create_time:
|
|
description: 日程创建时间,格式:yyyy-MM-dd HH:mm:ss，如 2024-07-23 14:55:33
|
|
type: string
|
|
description:
|
|
description: 日程描述
|
|
type: string
|
|
end_time:
|
|
description: 日程结束时间,格式:yyyy-MM-dd HH:mm:ss，如 2024-07-22 17:05:00
|
|
type: string
|
|
event_id:
|
|
description: 日程 ID
|
|
type: string
|
|
event_organizer:
|
|
description: 日程组织者信息
|
|
properties:
|
|
display_name:
|
|
description: 日程组织者姓名
|
|
type: string
|
|
user_id:
|
|
description: 日程组织者 ID
|
|
type: string
|
|
type: object
|
|
organizer_calendar_id:
|
|
description: 日程组织者日历 ID
|
|
type: string
|
|
recurrence:
|
|
description: 重复日程的重复性规则
|
|
type: string
|
|
start_time:
|
|
description: 日程开始时间,格式:yyyy-MM-dd HH:mm:ss，如 2024-07-22 16:05:00
|
|
type: string
|
|
status:
|
|
description: 日程状态
|
|
type: string
|
|
summary:
|
|
description: 日程标题
|
|
type: string
|
|
type: object
|
|
log_id:
|
|
description: 日志id
|
|
type: string
|
|
msg:
|
|
description: 返回信息
|
|
type: string
|
|
type: object
|
|
description: new desc
|
|
default:
|
|
description: ""
|
|
summary: 创建日程
|
|
/calendar/delete_event/{event_id}:
|
|
delete:
|
|
operationId: delete_event
|
|
parameters:
|
|
- description: 日程 ID，例如：e8b9791c-39ae-4908-8ad8-66b13159b9fb_0
|
|
in: path
|
|
name: event_id
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- description: 删除日程是否给日程参与人发送Bot通知
|
|
in: query
|
|
name: need_notification
|
|
schema:
|
|
default: "true"
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
responses:
|
|
"200":
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
code:
|
|
description: 错误码，非 0 表示失败
|
|
type: integer
|
|
log_id:
|
|
description: 链路追踪 id
|
|
type: string
|
|
msg:
|
|
description: 错误描述
|
|
type: string
|
|
type: object
|
|
description: new desc
|
|
default:
|
|
description: ""
|
|
summary: 删除日程
|
|
/calendar/get_primary_calendar:
|
|
get:
|
|
operationId: get_primary_calendar
|
|
parameters:
|
|
- description: 用户 ID 类型
|
|
in: query
|
|
name: user_id_type
|
|
schema:
|
|
default: open_id
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
responses:
|
|
"200":
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
code:
|
|
description: 错误码，非 0 表示失败
|
|
type: integer
|
|
data:
|
|
description: 返回数据
|
|
properties:
|
|
calendars:
|
|
description: 主日历列表
|
|
items:
|
|
description: 日历实体信息
|
|
properties:
|
|
calendar:
|
|
description: 日历实体信息
|
|
properties:
|
|
calendar_id:
|
|
description: 日历 ID
|
|
type: string
|
|
color:
|
|
description: 日历颜色，由颜色 RGB 值的 int32 表示
|
|
type: integer
|
|
description:
|
|
description: 日历描述
|
|
type: string
|
|
is_deleted:
|
|
description: 对于当前身份，日历是否已经被标记为删除
|
|
type: boolean
|
|
is_third_party:
|
|
description: 当前日历是否是第三方数据
|
|
type: boolean
|
|
permissions:
|
|
description: 日历公开范围，private：私密，show_only_free_busy：仅展示忙闲信息，public：公开，他人可查看日程详情
|
|
type: string
|
|
role:
|
|
description: 当前身份对于该日历的访问权限
|
|
type: string
|
|
summary:
|
|
description: 日历标题
|
|
type: string
|
|
summary_alias:
|
|
description: 日历备注名
|
|
type: string
|
|
type:
|
|
description: 日历类型
|
|
type: string
|
|
type: object
|
|
user_id:
|
|
description: 日历创建者的 User ID
|
|
type: string
|
|
type: object
|
|
type: array
|
|
type: object
|
|
log_id:
|
|
description: 链路追踪 id
|
|
type: string
|
|
msg:
|
|
description: 错误描述
|
|
type: string
|
|
type: object
|
|
description: new desc
|
|
default:
|
|
description: ""
|
|
summary: 查询主日历信息
|
|
/calendar/list_events:
|
|
get:
|
|
operationId: list_events
|
|
parameters:
|
|
- description: 一次请求要求返回的最大日程数量，范围50-1000
|
|
in: query
|
|
name: page_size
|
|
schema:
|
|
default: "50"
|
|
type: string
|
|
- description: 分页标记
|
|
in: query
|
|
name: page_token
|
|
schema:
|
|
type: string
|
|
- description: 开始时间,不传值时默认当天0点时间,格式:yyyy-MM-dd HH:mm:ss,如:2006-01-02 15:04:05
|
|
in: query
|
|
name: start_time
|
|
schema:
|
|
type: string
|
|
- description: 结束时间,不传值时默认当天23:59分时间,格式:yyyy-MM-dd HH:mm:ss,如:2006-01-02 15:04:05
|
|
in: query
|
|
name: end_time
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
responses:
|
|
"200":
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
code:
|
|
description: 错误码，非 0 表示失败
|
|
type: integer
|
|
data:
|
|
description: 返回数据
|
|
properties:
|
|
has_more:
|
|
description: 是否还有更多项
|
|
type: boolean
|
|
items:
|
|
description: 日程列表，结果为空时返回空数组
|
|
items:
|
|
description: 日程信息
|
|
properties:
|
|
app_link:
|
|
description: 日程的 app_link，跳转到具体的某个日程
|
|
type: string
|
|
create_time:
|
|
description: 日程创建时间,格式:yyyy-MM-dd HH:mm:ss,如:2006-01-02 15:04:05
|
|
type: string
|
|
description:
|
|
description: 日程描述
|
|
type: string
|
|
end_time:
|
|
description: 结束时间,格式:yyyy-MM-dd HH:mm:ss,如:2006-01-02 17:04:05
|
|
type: string
|
|
event_id:
|
|
description: 日程 ID
|
|
type: string
|
|
event_organizer:
|
|
description: 日程组织者信息
|
|
properties:
|
|
display_name:
|
|
description: 日程组织者姓名
|
|
type: string
|
|
user_id:
|
|
description: 日程组织者 user ID
|
|
type: string
|
|
type: object
|
|
organizer_calendar_id:
|
|
description: 日程组织者的日历 ID
|
|
type: string
|
|
recurrence:
|
|
description: 重复日程的重复性规则
|
|
type: string
|
|
start_time:
|
|
description: 开始时间,格式:yyyy-MM-dd HH:mm:ss,如:2006-01-02 15:04:05
|
|
type: string
|
|
status:
|
|
description: 日程状态
|
|
type: string
|
|
summary:
|
|
description: 日程标题
|
|
type: string
|
|
type: object
|
|
type: array
|
|
page_token:
|
|
description: 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token
|
|
type: string
|
|
type: object
|
|
log_id:
|
|
description: 链路追踪 id
|
|
type: string
|
|
msg:
|
|
description: 错误描述
|
|
type: string
|
|
type: object
|
|
description: new desc
|
|
default:
|
|
description: ""
|
|
summary: 获取日程列表
|
|
/calendar/search_events:
|
|
post:
|
|
operationId: search_events
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
end_time:
|
|
description: 日程搜索区间的结束时间，不传默认取当天23:59分时间，格式：2024-08-12 23:00:00
|
|
type: string
|
|
page_size:
|
|
default: 20
|
|
description: 一次调用所返回的最大日程数量，最大值100
|
|
type: integer
|
|
page_token:
|
|
description: 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果
|
|
type: string
|
|
query:
|
|
description: 搜索关键字，用于模糊查询日程名称，最大输入200字符数，必填，不允许空串
|
|
type: string
|
|
start_time:
|
|
description: 日程搜索区间的开始时间，不传默认取当天0点时间，格式：2024-08-01 10:00:00
|
|
type: string
|
|
user_id_type:
|
|
default: open_id
|
|
description: 用户 ID 类型，枚举值：open_id、union_id、user_id
|
|
type: string
|
|
required:
|
|
- query
|
|
type: object
|
|
responses:
|
|
"200":
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
code:
|
|
description: 错误码，0表示成功，其他值表示失败
|
|
type: integer
|
|
data:
|
|
description: 返回数据
|
|
properties:
|
|
items:
|
|
description: 日程列表
|
|
items:
|
|
description: 日程信息
|
|
properties:
|
|
app_link:
|
|
description: 日程的 app_link，跳转到具体的某个日程
|
|
type: string
|
|
description:
|
|
description: 日程描述
|
|
type: string
|
|
end_time:
|
|
description: 日程结束时间,格式：2024-08-18 01:00:00
|
|
type: string
|
|
event_id:
|
|
description: 日程 ID，如：46b9231b-244e-4d3c-845e-0a4d25469b5b_0
|
|
type: string
|
|
organizer_calendar_id:
|
|
description: 日程组织者的日历 ID
|
|
type: string
|
|
recurrence:
|
|
description: 重复日程的重复性规则
|
|
type: string
|
|
start_time:
|
|
description: 日程开始时间,格式：2024-08-18 00:30:00
|
|
type: string
|
|
status:
|
|
description: 日程状态，可选值有 tentative ：未回应；confirmed：已确认；
|
|
type: string
|
|
summary:
|
|
description: 日程标题
|
|
type: string
|
|
type: object
|
|
type: array
|
|
page_token:
|
|
description: 分页token
|
|
type: string
|
|
type: object
|
|
log_id:
|
|
description: 日志 ID
|
|
type: string
|
|
msg:
|
|
description: 错误信息
|
|
type: string
|
|
type: object
|
|
description: new desc
|
|
default:
|
|
description: ""
|
|
summary: 搜索日程
|
|
/calendar/update_event/{event_id}:
|
|
patch:
|
|
operationId: update_event
|
|
parameters:
|
|
- description: 日程 ID，例如：e8b9791c-39ae-4908-8ad8-66b13159b9fb_0
|
|
in: path
|
|
name: event_id
|
|
required: true
|
|
schema:
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
auto_record:
|
|
description: 开启自动录制，true：录制，false：不录制，不传则不更新此字段
|
|
type: boolean
|
|
description:
|
|
description: 日程描述，空表示不更新该字段
|
|
type: string
|
|
end_time:
|
|
description: 日程结束时间，格式：2024-07-22 22:30:00，不传该字段则不更新
|
|
type: string
|
|
need_notification:
|
|
description: 更新日程时是否发送bot消息，不传则不更新
|
|
type: boolean
|
|
start_time:
|
|
description: 日程开始时间，格式：2024-07-22 22:30:00，不传该字段则不更新
|
|
type: string
|
|
summary:
|
|
description: 日程标题，空表示不更新该字段
|
|
type: string
|
|
type: object
|
|
responses:
|
|
"200":
|
|
content:
|
|
application/json:
|
|
schema:
|
|
properties:
|
|
code:
|
|
description: 错误码，非 0 表示失败
|
|
type: number
|
|
log_id:
|
|
description: 链路追踪 id
|
|
type: string
|
|
msg:
|
|
description: 错误描述
|
|
type: string
|
|
type: object
|
|
description: new desc
|
|
default:
|
|
description: ""
|
|
summary: 更新日程
|
|
servers:
|
|
- url: https://lark-plugin-api.solutionsuite.cn/lark-plugin
|