获取日程列表

获取某个日程子频道中当天的日程列表。

使用示例

sync

import qqbot
token = qqbot.Token({appid}, {token})
def demo():
    api = qqbot.ScheduleAPI(token, False)
    schedules = api.get_schedules(channel_id, since)

async

import qqbot
token = qqbot.Token({appid}, {token})
async def demo():
    api = qqbot.AsyncScheduleAPI(token, False)
    schedules = await api.get_schedules(channel_id, since)

参数说明

字段名	必填	类型	描述
channel_id	是	string	子频道 ID
since	否	string	起始时间戳(`ms`)

::: warning 注意

since 需是毫秒级别的时间戳（13位）。

若带了参数 since，则返回结束时间在 since 之后的日程列表；若未带参数 since，则默认返回当天的日程列表。

:::

返回说明

返回 Schedule 数组。

Schedule

字段名	类型	描述
id	string	日程 ID
name	string	日程名称
description	string	日程描述
start_timestamp	string	日程开始时间戳(`ms`)
end_timestamp	string	日程结束时间戳(`ms`)
creator	Member	创建者
jump_channel_id	string	日程开始时跳转到的子频道 ID
remind_type	string	日程提醒类型，取值参考RemindType

Member

字段名	类型	描述
user	User	用户的频道基础信息，只有成员相关接口中会填充此信息
nick	string	用户在频道内的昵称
joined_at	string	用户加入频道的时间，是个 `ISO8601 timestamp` 字符串，例：”2021-11-23T15:16:48+08:00”

User

字段名	类型	描述
id	string	用户 ID
username	string	用户名
bot	boolean	是否是机器人

RemindType

提醒类型 id	描述
0	不提醒
1	开始时提醒
2	开始前 5 分钟提醒
3	开始前 15 分钟提醒
4	开始前 30 分钟提醒
5	开始前 60 分钟提醒

返回示例

data：

[
  {
    "id": "xxxxxx",
    "name": "xxxxxx",
    "description": "xxxxxx",
    "start_timestamp": "1641913200000",
    "end_timestamp": "1641916800000",
    "creator": {
      "user": {
        "id": "xxxxxx",
        "username": "xxxxxx",
        "bot": false
      },
      "nick": "",
      "joined_at": "2021-11-24T16:51:35+08:00"
    },
    "jump_channel_id": "0",
    "remind_type": "2"
  }
]