koishi-plugin-qqwebapi

为 QQ 平台开发者增加一些好用的 webapi

接口文档

QQWebApi

getStrangerInfo(user_id: string | number): Promise<StrangerInfo | null>

获取陌生人信息。

• 参数
  • user_id：QQ 用户 ID
• 返回
  • StrangerInfo 对象或 null

StrangerInfo

陌生人信息对象。

• 字段
  • name：用户名
  • head_url：头像 URL，不一定能拿到
  • sign：签名
  • age：年龄
  • gender：性别
  • country：国家
  • province：省份
  • city：城市
  • level：等级
  • qid：自定义的 QID
  • qzone_level：Qzone 等级
  • qzone_score：Qzone 分数
  • upgrade_level：Qzone 升级所需等级
  • need_score：Qzone 需要分数

getUsername(user_id: string | number): Promise<string | null>

获取用户名。

• 参数
  • user_id：QQ 用户 ID
• 返回
  • 用户名字符串或 null

getGroupAvatar(group_id: string | number, quality?: 40 | 100 | 140 | 640): Promise<Buffer | null>

获取群头像。

• 参数
  • group_id：群组 ID
  • quality：头像质量（默认 100）
• 返回
  • 头像 Buffer 或 null

getGroupAvatarUrl(group_id: string | number, quality?: 40 | 100 | 140 | 640): string

获取群头像 URL。

• 参数
  • group_id：群组 ID
  • quality：头像质量（默认 100）
• 返回
  • 头像 URL 字符串

getUserAvatar(user_id: string | number, quality?: 40 | 100 | 140 | 640, file_type?: string): Promise<Buffer | null>

获取用户头像。

• 参数
  • user_id：用户 ID
  • quality：头像质量（默认 100）
  • file_type：文件类型（可选）
• 返回
  • 头像 Buffer 或 null

getUserAvatarUrl(user_id: string | number, quality?: 40 | 100 | 140 | 640, file_type?: string): string

获取用户头像 URL。

• 参数
  • user_id：用户 ID
  • quality：头像质量（默认 100）
  • file_type：文件类型（可选）
• 返回
  • 头像 URL 字符串