系统 API
get_login_info 获取登录信息
输入参数
此 API 无输入参数,请应用端传入 {}。
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| uin | int64 | 登录 QQ 号 |
| nickname | string | 登录昵称 |
get_impl_info 获取协议端信息
输入参数
此 API 无输入参数,请应用端传入 {}。
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| impl_name | string | 协议端名称 |
| impl_version | string | 协议端版本 |
| qq_protocol_version | string | 协议端使用的 QQ 协议版本 |
| qq_protocol_type | enum | 协议端使用的 QQ 协议平台,可能值:windows linux macos android_pad android_phone ipad iphone harmony watch |
| milky_version | string | 协议端实现的 Milky 协议版本,目前为 "1.2" |
get_user_profile 获取用户个人信息
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| user_id | int64 | 用户 QQ 号 |
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| nickname | string | 昵称 |
| qid | string | QID |
| age | int32 | 年龄 |
| sex | enum | 性别,可能值:male female unknown |
| remark | string | 备注 |
| bio | string | 个性签名 |
| level | int32 | QQ 等级 |
| country | string | 国家或地区 |
| city | string | 城市 |
| school | string | 学校 |
get_friend_list 获取好友列表
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| no_cache | boolean | 是否强制不使用缓存,默认值:false |
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| friends | FriendEntity[] | 好友列表 |
get_friend_info 获取好友信息
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| user_id | int64 | 好友 QQ 号 |
| no_cache | boolean | 是否强制不使用缓存,默认值:false |
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| friend | FriendEntity | 好友信息 |
get_group_info 获取群信息
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| group_id | int64 | 群号 |
| no_cache | boolean | 是否强制不使用缓存,默认值:false |
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| group | GroupEntity | 群信息 |
get_group_member_list 获取群成员列表
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| group_id | int64 | 群号 |
| no_cache | boolean | 是否强制不使用缓存,默认值:false |
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| members | GroupMemberEntity[] | 群成员列表 |
get_group_member_info 获取群成员信息
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| group_id | int64 | 群号 |
| user_id | int64 | 群成员 QQ 号 |
| no_cache | boolean | 是否强制不使用缓存,默认值:false |
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| member | GroupMemberEntity | 群成员信息 |
get_peer_pins 获取置顶的好友和群列表
输入参数
此 API 无输入参数,请应用端传入 {}。
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| friends | FriendEntity[] | 置顶的好友列表 |
| groups | GroupEntity[] | 置顶的群列表 |
set_peer_pin 设置好友或群的置顶状态
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| message_scene | enum | 要设置的会话的消息场景,可能值:friend group temp |
| peer_id | int64 | 要设置的好友 QQ 号或群号 |
| is_pinned | boolean | 是否置顶, false 表示取消置顶,默认值:true |
输出参数
此 API 无输出参数,请协议端传入 {}。
set_avatar 设置 QQ 账号头像
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| uri | string | 头像文件 URI,支持 file:// http(s):// base64:// 三种格式 |
输出参数
此 API 无输出参数,请协议端传入 {}。
set_nickname 设置 QQ 账号昵称
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| new_nickname | string | 新昵称 |
输出参数
此 API 无输出参数,请协议端传入 {}。
set_bio 设置 QQ 账号个性签名
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| new_bio | string | 新个性签名 |
输出参数
此 API 无输出参数,请协议端传入 {}。
get_custom_face_url_list 获取自定义表情 URL 列表
输入参数
此 API 无输入参数,请应用端传入 {}。
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| urls | string[] | 自定义表情 URL 列表 |
get_csrf_token 获取 CSRF Token
输入参数
此 API 无输入参数,请应用端传入 {}。
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| csrf_token | string | CSRF Token |