GET CLASS
---
### ```getAnonymousInfo```「取匿名成员信息」
#### 请求数据
~~~
{
"fun":"getAnonymousInfo",
"source":"AAAAAyys="
}
~~~
##### 参数说明
| 参数名 | 值类型 | 说明 |
| --- | --- | --- |
| ```source``` | string | 匿名成员的标识，即插件提交的参数```fromAnonymous``` |
#### 响应数据
~~~
{
"status":0,
"result":{
"aid":1000013,
"code":"曹植",
"token":"McFYb54/3LKw=="
}
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | object | 匿名成员信息 |
| ```result.aid``` | int | 匿名成员ID |
| ```result.code``` | string | 匿名成员代号，如```大力鬼王``` |
| ```result.token``` | string | 匿名成员Token，此参数值经过base64编码，原数据为数据流类型 |
### ```getAuthInfo```「取权限信息」
#### 说明
* 可能需要权限```20```
#### 请求数据
~~~
{
"fun":"getAuthInfo",
"domain":"qun.qq.com"
}
~~~
##### 请求参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| `domain` | string | `-` | 要获取Cookie数据的域名 |
#### 响应数据
~~~
{
"status":0,
"result":{
"authCode":87,
"cookies":"uin=o1; skey=MhT4Yo; vkey=Ekj%3D; sid=Ac4ob4p",
"csrfToken":1064
}
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | object | AuthInfo |
| ```result.authCode``` | int | AuthCode，似乎没什么用 |
| ```result.cookies``` | string | Cookies |
| ```result.csrfToken``` | number | CsrfToken，即QQ网页用到的 bkn/g_tk等 |
### ```getBanList```「取群中被禁言成员列表」
#### 说明
* 需要权限```20```
* 需要机器人有管理权限
#### 请求数据
~~~
{
"fun":"getBanList",
"group":123456
}
~~~
##### 参数说明
| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| ```group``` | number | 群号 |
#### 响应数据
~~~
{
"status":0,
"result":[
{
"nick":"interesting",
"t":597,
"uin":11111
},
{
"manager":1,
"nick":" ",
"t":246849,
"uin":123456
}
]
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | array | 被禁言的成员列表信息 |
| ```result[i]``` | object | 被禁言的第```i+1```个成员信息 |
| ```result[i].manager``` | int | 该成员是否为管理，此字段固定为1；**当成员非管理时，此字段不存在** |
| ```result[i].nick``` | string | 该成员的群名片 |
| ```result[i].t``` | int | 该成员离解禁的剩余时间，单位：秒 |
| ```result[i].uin``` | number | 该成员的QQ号 |
### ```getFileInfo```「取文件信息」
#### 说明
* 需要权限`20`，用于获取文件的下载链接
#### 请求数据
~~~
{
"fun":"getFileInfo",
"group":"1234567"
"source":"ACUvYTAAGAY="
}
~~~
##### 参数说明
| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| ```source``` | string | 文件标识，即插件所提交的参数```file``` |
| ```group``` | string | 对应QQ群号码 |
#### 响应数据
~~~
{
"status":0,
"result":{
"fun":"getFileInfo",
"source":"ACUAAGAY=",
"size":40207871,
"busid":102,
"name":"com.kuaikan.comic-1.apk",
"id":"/a04e806e-2b5e-480b-923a-a0d99a33ad9d"
}
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | object | 文件信息数组 |
| ```result.size``` | number | 文件大小，单位：字节(B) |
| ```result.busid``` | int | 文件的BUSID |
| ```result.name``` | string | 文件名 |
| ```result.id``` | string | 文件ID |
### ```getFriendList```「取好友列表」
#### 说明
* 需要权限```20```
#### 请求数据
~~~
{
"fun":"getFriendList"
}
~~~
#### 响应数据
~~~
{
"status":0,
"result":{
"1":{
"gname":"disKnow",
"mems":[
{
"name":"BBQ",
"uin":99999
}
]
},
"2":{
"gname":"ther",
"mems":[
{
"name":"友人A",
"uin":12345
}
]
}
}
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | array | 好友列表数组 |
| ```result[i]``` | array | 第```i+1```个分组信息 |
| ```result[i].gname``` | string | 该分组的组名 |
| ```result[i].mems``` | array | 该分组的用户列表信息 |
| ```result[i].mems[n]``` | array | 该分组的第```n+1```个用户信息 |
| ```result[i].mems[n].name``` | string | 该用户的备注 |
| ```result[i].mems[n].uin``` | number | 该用户的QQ号 |
### ```getGroupHomeworkList```「取群作业列表」
#### 说明
* 需要权限```20```
#### 请求数据
~~~
{
"fun":"getGroupHomeworkList",
"group":12345,
"number":10
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```group``` | number | - | 群号 |
| ```number``` | int | ```10``` | 取出数量 |
#### 响应数据
~~~
{
"status":0,
"result":[
{
"content":{
"c":[
{
"text":"在线习题作业（3题）知识点考查：电荷守恒定律元电荷",
"type":"str"
}
]
},
"course_id":100,
"course_name":"物理",
"course_pic":"http://p.qpic.cn/qqconadmin/0/11111111/0",
"flag":16,
"hw_id":17139600,
"hw_title":"物理作业",
"hw_type":0,
"icon":"http://p.qpic.cn/qqconadmin/0/1112223131/0",
"need_feedback":true,
"pnick_name":"精神病",
"puin":11223456,
"status":0,
"team_id":0,
"ts_create":1498097800
}
]
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | array | 作业信息列表 |
| ```result[i]``` | object | 第```i+1```个作业信息 |
| ```result[i].content``` | object | 该作业的内容信息数组 |
| ```result[i].content.c[n].text``` | string | 该作业的内容 |
| ```result[i].content.c[n].tpe``` | string | 该作业的内容类型 |
| ```result[i].course_id``` | int | 该作业的科目ID |
| ```result[i].course_name``` | string | 该作业的科目名 |
| ```result[i].course_pic``` | string | 该作业的科目图片链接 |
| ```result[i].hw_id``` | number | 该作业ID |
| ```result[i].hw_title``` | string | 该作业的标题 |
| ```result[i].hw_type``` | int | 该作业的类型ID |
| ```result[i].icon``` | string | 该作业的图标链接 |
| ```result[i].need_feedback``` | bool | 该作业需要反馈，```true```/需要，```false```/不需要 |
| ```result[i].pnick_name``` | string | 发布该作业的发布人名片 |
| ```result[i].puin``` | number | 发布该作业的发布人QQ |
| ```result[i].status``` | int | 该作业的目前状态 |
| ```result[i].team_id``` | int | 该作业属于哪个团队的(根据官方政策，无用) |
| ```result[i].ts_create``` | int | 该作业的创建时间，时间戳形式 |
### ```getGroupInfo```「取群详细信息」
#### 说明
* 需要权限```20```
#### 请求数据
~~~
{
"fun":"getGroupInfo",
"group":123456
}
~~~
##### 参数说明
| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| ```group``` | number | 群号 |
#### 响应数据
~~~
{
"status":0,
"result":{
"ac_grade":2,
"ac_num":34,
"ac_open":1,
"app_privilege_flag":98913,
"auth":0,
"class":"",
"classID":10066,
"ec":0,
"edu":0,
"flag":2,
"gAdmins":[
11223456,
11223455
],
"gBoard":"最新公告",
"gCrtTime":1466098191,
"gIntro":"群介绍压缩版",
"gLevel":0,
"gMaxMem":500,
"gMemNum":87,
"gName":"Zero",
"gOwner":257570,
"gRIntro":"群介绍完整版",
"gSpeClass":0,
"gc":4639,
"gtype":0,
"level_def":0,
"levelname":{
"lvln1":"潜水",
"lvln10":"一见倾心",
"lvln11":"超凡脱俗",
"lvln12":"风华绝代",
"lvln13":"崭露头角",
"lvln14":"金玉满堂",
"lvln15":"富甲一方",
"lvln197":"小酋长",
"lvln198":"大酋长",
"lvln199":"首席酋长",
"lvln2":"冒泡",
"lvln3":"吐槽",
"lvln4":"活跃",
"lvln5":"话唠",
"lvln6":"传说"
},
"ns":{
"11223456":"精神病",
"11223455":"?????"
},
"open":0,
"photo":{
"f":0
},
"pos":"0|0.100000|0.100000|",
"search":1,
"share":{
"f":0
},
"sys_show":1,
"tags":[
{
"md":"0137fe83ea6f849",
"sTid":"39303163343030303039356433",
"tag":"你不知道",
"u":257570
}
],
"user_show":1
}
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | object | 群信息数组 |
| ```result.ac_grade``` | int | 群等级 |
| ```result.ac_open``` | int | 推测是加群方式 |
| ```result.class``` | string | 推测是群类型 |
| ```result.classID``` | int | 推测是群类型ID |
| ```result.ec``` | int | 调用api的结果(相当于状态码) |
| ```result.gAdmins``` | array | 群管理QQ列表 |
| ```result.gBoard``` | string | 最新公告内容 |
| ```result.gCrtTime``` | int | 建群时间的时间戳 |
| ```result.gIntro``` | string | 群介绍(压缩版) |
| ```result.gLevel``` | int | 推测是群等级 |
| ```result.gMaxMem``` | int | 群成员上限 |
| ```result.gMemNum``` | int | 目前群人数 |
| ```result.gName``` | string | 群名 |
| ```result.gOwner``` | number | 群主QQ |
| ```result.gRIntro``` | string | 群介绍(完整版) |
| ```result.gc``` | number | 群号 |
| ```result.gtype``` | int | 推测是群类型 |
| ```result.levelname``` | object | 群成员等级信息 |
| ```result.ns``` | object | 群管理和群主的昵称列表 |
| ```result.pos``` | string | 推测是群地点信息 |
| ```result.search``` | int | 推测是群搜索类型(是否限定通过群号查找) |
| ```result.tags``` | array | 群标签信息列表 |
| ```result.tags[i]``` | object | 第```i+1```个群标签信息 |
| ```result.tags[i].md``` | string | 推测是该标签的md5值 |
| ```result.tags[i].tag``` | string | 该标签的名称 |
| ```result.tags[i].u``` | number | 该标签的创建者QQ |
### ```getGroupLinkList```「取群链接列表」
#### 说明
* 需要权限```20```
#### 请求数据
~~~
{
"fun":"getGroupLinkList",
"group":12345,
"number":10
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```group``` | number | - | 群号 |
| ```number``` | int | ```10``` | 取出数量 |
#### 响应数据
~~~
{
"status":0,
"result":[
{
"raw_url":"https://www.appnode.com/?0ja3cp",
"seq":243,
"thumbnail":"https://www.appnode.com/images/logo-s.gif",
"time":1502607100,
"title":"正在加载活动页面...",
"uin":12345
}
]
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | array | 链接信息列表 |
| ```result[i]``` | object | 第```i+1```个链接信息 |
| ```result[i].raw_url``` | string | 该链接发出来时的url |
| ```result[i].thumbnail``` | string | 该链接的站点图片 |
| ```result[i].time``` | int | 该链接发布时间，时间戳形式 |
| ```result[i].title``` | string | 该链接的简要内容 |
| ```result[i].uin``` | number | 发布该链接的QQ |
### ```getGroupList```「取群列表」
#### 说明
* 需要权限```161```
* 需要权限`132`(获取群人数信息时)
#### 请求数据
~~~
{
"fun":"getGroupList",
"getMemberNumber":true,
"cache":true
}
~~~
##### 请求参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| `getMemberNumber` | bool | `false` | 获取群成员数量信息 |
| `cache` | bool | `true` | 使用缓存的群成员数量信息, 仅在`getMemberNumber`为`true`时有效 |
#### 响应数据
~~~
{
"status":0,
"result":[
{
"id":12345,
"name":"10000",
"memberQuantity":150,
"memberCapacity":500,
"headimg":"http://p.qlogo.cn/gh/67890"
}
]
}
~~~
##### 响应字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | array | 群信息列表 |
| ```result[i]``` | object | 第```i+1```个群信息 |
| ```result[i].name``` | string | 群名，url编码 |
| ```result[i].id``` | number | 群号 |
| ```result[i].memberQuantity``` | number | 群当前人数，仅在`getMemberNumber`为`true`时有效 |
| ```result[i].memberCapacity``` | number | 群人数上限，仅在`getMemberNumber`为`true`时有效 |
| ```result[i].headimg``` | string | 群头像链接 |
### ```getGroupMemberInfo```「取群成员信息」
#### 说明
* 需要权限```130```
#### 请求数据
~~~
{
"fun":"getGroupMemberInfo",
"group":12345,
"qq":2361257570,
"cache":1
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```group``` | number | - | 群号 |
| ```qq``` | number | - | qq号 |
| ```cache``` | int | ```1``` | 使用缓存，```0```/不使用，```1```/使用 |
#### 响应数据
~~~
{
"status":0,
"result":{
"group":12345,
"qq":67890,
"name":"name",
"card":"card",
"gender":0,
"old":18,
"city":"",
"joinTime":1466098191,
"lastTime":1503840192,
"power":3,
"tip":"自定义头衔",
"level":"传说",
"inBlackList":0,
"allowChangeCard":1,
"tipExpireTime":-1,
"headimg":"http://q.qlogo.cn/headimg_dl?bs=qq&dst_uin=67890&spec=100"
}
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | object | 群成员信息 |
| ```result.group``` | number | 群号 |
| ```result.qq``` | number | QQ号 |
| ```result.name``` | string | QQ昵称 |
| ```result.card``` | string | 群名片 |
| ```result.gender``` | int | 性别ID，`0`/男性，`1`/女性，`255`/未知 |
| ```result.city``` | string | 所在城市 |
| ```result.joinTime``` | int | 加群时间，时间戳形式 |
| ```result.lastTime``` | int | 最后发言时间，时间戳形式 |
| ```result.power``` | int | 管理权限，`1`/成员，`2`/管理，`3`/群主 |
| ```result.tip``` | string | 专属头衔 |
| ```result.level``` | string | 群成员等级所对应的等级名称 |
| ```result.card``` | string | 群名片 |
| ```result.inBlackList``` | int | 不良用户，`0`/不是，`1`/是 |
| ```result.allowChangeCard``` | int | 允许修改名片，`0`/不允许，`1`/允许 |
| ```result.tipExpireTime``` | int | 头衔有效期，时间戳形式，`-1`为永不到期 |
| ```result.headimg``` | string | QQ头像 |
| ```result.banTime``` | int | 禁言剩余时间，单位：秒，该值需提供Cookies并且需具有管理员权限，`-1`/未获取到，`0`/为被禁言 |
### ```getGroupMemberList```「取群成员列表」
#### 说明
* 需要权限```160```
#### 请求数据
~~~
{
"fun":"getGroupMemberList",
"group":12345
}
~~~
##### 参数说明
| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| ```group``` | number | 群号 |
#### 响应数据
~~~
{
"status":0,
"result":[
{
"group":12345,
"qq":67890,
"name":"le",
"card":"",
"gender":255,
"old":0,
"city":"",
"joinTime":1501576738,
"lastTime":1501829899,
"power":1,
"tip":"",
"level":"",
"inBlackList":0,
"allowChangeCard":0,
"tipExpireTime":0,
"headimg":"http://q.qlogo.cn/headimg_dl?bs=qq&dst_uin=0&spec=100"
}
]
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | array | 群成员信息 |
| ```result[i]``` | object | 第```i+1```个群成员信息 |
| ```result[i].group``` | number | 群号 |
| ```result[i].qq``` | number | QQ号 |
| ```result[i].name``` | string | QQ昵称 |
| ```result[i].card``` | string | 群名片 |
| ```result[i].gender``` | int | 性别ID，`0`/男性，`1`/女性，`255`/未知 |
| ```result[i].city``` | string | 所在城市 |
| ```result[i].joinTime``` | int | 加群时间，时间戳形式 |
| ```result[i].lastTime``` | int | 最后发言时间，时间戳形式 |
| ```result[i].power``` | int | 管理权限，`1`/成员，`2`/管理，`3`/群主 |
| ```result[i].tip``` | string | 专属头衔 |
| ```result[i].level``` | string | 群成员等级所对应的等级名称 |
| ```result[i].card``` | string | 群名片 |
| ```result[i].inBlackList``` | int | 不良用户，`0`/不是，`1`/是 |
| ```result[i].allowChangeCard``` | int | 允许修改名片，`0`/不允许，`1`/允许 |
| ```result[i].tipExpireTime``` | int | 头衔有效期，时间戳形式，`-1`为永不到期 |
| ```result[i].headimg``` | string | QQ头像 |
### ```getGroupNoteList```「取群公告列表」
#### 说明
* 需要权限```20```
#### 请求数据
~~~
{
"fun":"getGroupNoteList",
"group":12345,
"number":10
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```group``` | number | - | 群号 |
| ```number``` | int | ```10``` | 取出数量 |
#### 响应数据
~~~
{
"status":0,
"result":[
{
"cn":0,
"fid":"890aa71260400",
"fn":0,
"msg":{
"pics":[
{
"id":"XfzBqF5ggFwRKRSQ05ctWJY7Hc"
}
],
"text":"xxx",
"text_face":"xxxa",
"title":"领取授权通知"
},
"pubt":1492941154,
"read_num":1,
"settings":{
"is_show_edit_card":0
},
"type":6,
"u":67890,
"vn":0
}
]
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | array | 公告信息数组 |
| ```result[i]``` | object | 第```i+1```个公告信息 |
| ```result[i].fid``` | string | 公告ID |
| ```result[i].msg``` | object | 公告信息数组 |
| ```result[i].msg.text``` | string | 公告内容(完整) |
| ```result[i].msg.text_face``` | string | 公告内容(预览) |
| ```result[i].msg.title``` | string | 公告标题 |
| ```result[i].pubt``` | int | 发布时间戳 |
| ```result[i].read_num``` | int | 已阅读的人数 |
| ```result[i].settings``` | object | 公告附带的信息 |
| ```result[i].settings.is_show_edit_card``` | int | 提醒群成员修改名片，1/提醒，0/不提醒 |
| ```result[i].type``` | int | 公告类型ID |
| ```result[i].u``` | number | 发布人QQ |
### ```getGroupTopNote```「取群置顶公告」
#### 说明
* 需要权限```20```
#### 请求数据
~~~
{
"fun":"getGroupTopNote",
"group":123456
}
~~~
##### 参数说明
| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| ```group``` | number | 群号 |
#### 响应数据
~~~
{
"status":0,
"result":{
"cn":0,
"fid":"890aa71bc9b5784da0e00",
"fn":0,
"msg":{
"text":"",
"text_face":"",
"title":"本群须知"
},
"pubt":1469779056,
"read_num":1,
"settings":{
"is_show_edit_card":0
},
"type":20,
"u":10000,
"vn":0
}
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | object | 公告信息数组 |
| ```result.fid``` | string | 公告ID |
| ```result.msg``` | object | 公告信息数组 |
| ```result.msg.text``` | string | 公告内容(完整) |
| ```result.msg.text_face``` | string | 公告内容(预览) |
| ```result.msg.title``` | string | 公告标题 |
| ```result.pubt``` | int | 发布时间戳 |
| ```result.read_num``` | int | 已阅读的人数 |
| ```result.settings``` | object | 公告附带的信息 |
| ```result.settings.is_show_edit_card``` | int | 提醒群成员修改名片，1/提醒，0/不提醒 |
| ```result.type``` | int | 公告类型ID |
| ```result.u``` | number | 发布人QQ |
### ```getGroupSimpleInfo```「取群简单信息」
#### 说明
* 需要权限`132`
#### 请求数据
~~~
{
"fun":"getGroupSimpleInfo",
"group":12345,
"cache":true
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| `group` | number | - | 群名 |
| `cache` | bool | ```true``` | 使用缓存 |
#### 响应数据
~~~
{
"status":0,
"result":{
"id":12345,
"name":"女装",
"memberQuantity":150,
"memberCapacity":500
}
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | object | 图片信息 |
| ```result.id``` | number | 群号 |
| ```result.name``` | string | 群名 |
| ```result.memberQuantity``` | number | 群当前人数 |
| ```result.memberCapacity``` | number | 群人数上限 |
### ```getImageInfo```「取图片信息」
#### 说明
* 只能获取酷Q接收到的图片
#### 请求数据
~~~
{
"fun":"getImageInfo",
"source":"3FFB03403A91DB5.jpg",
"needFile":true
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```source``` | string | - | 图片文件名 |
| ```needFile``` | bool | ```true``` | 需要回传文件内容 |
#### 响应数据
~~~
{
"status":0,
"result":{
"md5":"3FFB03403A91DF",
"width":70,
"height":54,
"size":1656,
"url":"http://gchat.qpic.cn/",
"addTime":1502951368,
"file":"/9j/4QCcRXhpZgAASUkBAAAANgif//Z"
}
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | object | 图片信息 |
| ```result.md5``` | string | 图片的MD5值 |
| ```result.width``` | int | 图片宽度 |
| ```result.height``` | string | 图片高度 |
| ```result.size``` | int | 图片文件大小，单位：字节(B) |
| ```result.url``` | string | 图片的url地址，请注意QQ有防盗链机制，不能直接引用 |
| ```result.addTime``` | int | 图片上传到腾讯服务器的时间，时间戳形式 |
| ```result.file``` | string | 图片文件内容，已Base64编码处理 |
### ```getLoginQQInfo```「取登录QQ的信息」
#### 说明
* 该API可能需要权限```20```
#### 请求数据
~~~
{
"fun":"getLoginQQInfo"
}
~~~
#### 响应数据
~~~
{
"status":0,
"result":{
"nick":"萌萌",
"qq":105005,
"headimg":"http://q2.qlogo.cn/g?b=qq&k=JicnmIibic0Ku3MQx2lEvRibRQ&s=100&t=1483373010",
"level":41
}
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | object | QQ信息 |
| ```result.nick``` | string | QQ昵称 |
| ```result.qq``` | number | QQ号 |
| ```result.headimg``` | string | 头像链接 |
| ```result.level``` | int | QQ等级 |
### ```getMoreQQInfo```「批量取QQ信息」
#### 说明
* 需要权限```20```
#### 请求数据
~~~
{
"fun":"getMoreQQInfo",
"qqList":"10500-12345"
}
~~~
##### 参数说明
| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| ```qqList``` | string | QQ列表，每个QQ用```-```分开 |
#### 响应数据
~~~
{
"status":0,
"result":[
{
"n":"pony",
"u":10001,
"headimg":"http://q2.qlogo.cn/g?b=qq&k=Vjic48anMfN6ovAxw4eN94w&s=100&t=1483281655",
"level":37
},
{
"n":"一块乐",
"u":12345,
"headimg":"http://q2.qlogo.cn/g?b=qq&k=ffxWIb7R5Rzpia88aM9SNXg&s=100&t=1483281655",
"level":81
}
]
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | array | QQ信息 |
| ```result[i]``` | object | 第```i+1```个QQ信息 |
| ```result[i].n``` | string | QQ昵称 |
| ```result[i].u``` | string | QQ号 |
| ```result[i].headimg``` | string | 头像链接 |
| ```result[i].level``` | int | QQ等级 |
### ```getRecord```「接收语音文件」
#### 说明
* 需要权限```30```
#### 请求数据
~~~
{
"fun":"getRecord",
"source":"AE6CF8FE.silk",
"format":"mp3",
"needFile":true
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```source``` | string | - | 文件名，必须是消息中的语音文件(file) |
| ```format``` | string | ```mp3``` | 目标编码，目前支持 mp3,amr,wma,m4a,spx,ogg,wav,flac |
| ```needFile``` | boolean | ```true``` | 是否回传文件数据，```true```/回传，```false```/不回传 |
#### 响应数据
~~~
{
"status":0,
"result":{
"name":"F87451BBBBB973465AAB45CB66A1352D.mp3",
"file":"SUQzBAADTGF2ZjU2LjM2LjEqq"
}
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | object | 文件信息 |
| ```result.name``` | string | 转码后保存在语音目录下的文件名 |
| ```result.file``` | string | 已Base64编码的文件内容 |
### ```getRunStatus```「取运行状态」
#### 请求数据
~~~
{
"fun":"getRunStatus"
}
~~~
#### 响应数据
~~~
{
"status":0
}
~~~
##### 说明
* 该函数无其余返回值，仅在插件未出现无响应状态时正常返回数据
### ```getShareList```「取群文件列表」
#### 请求数据
~~~
{
"fun":"getShareList",
"group":12345
}
~~~
##### 参数说明
| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| ```group``` | number | 群号 |
#### 响应数据
~~~
{
"status":0,
"result":[
{
"auditflag":1,
"busid":102,
"createtime":1501217864,
"downloadtimes":10,
"filelenhight":0,
"filelenlow":550027,
"filename":"聊天.zip",
"filepath":"/102/a26d8444-4abb-4fdd-0000-39999717f03c",
"filesize":550427,
"localname":"",
"modifytime":1501217865,
"ownernick":"н",
"owneruin":20000,
"ttl":0,
"uploadlenhigh":0,
"uploadlenlow":550427,
"uploadnick":"н",
"uploadsize":550427,
"uploaduin":20000
}
]
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | array | 文件信息 |
| ```result[i]``` | object | 第```i+1```个文件信息 |
| ```result[i].busid``` | int | BUSID |
| ```result[i].createtime``` | int | 创建时间，时间戳形式 |
| ```result[i].downloadtimes``` | int | 下载次数 |
| ```result[i].filename``` | string | 文件名 |
| ```result[i].filepath``` | string | 在QQ服务器上的文件路径 |
| ```result[i].filesize``` | number | 文件大小，单位：字节(B) |
| ```result[i].localname``` | string | 本地文件名 |
| ```result[i].modifytime``` | int | 上传完成时间 |
| ```result[i].ownernick``` | string | 上传者的群名片 |
| ```result[i].owneruin``` | number | 上传者的QQ |
| ```result[i].uploadlenlow``` | number | 上传的文件大小 |
| ```result[i].uploadnick``` | string | 上传者的群名片 |
| ```result[i].uploadsize``` | number | 上传的文件大小 |
| ```result[i].uploaduin``` | number | 上传者的QQ |
### ```getStrangerInfo```「取陌生人信息」
#### 说明
* 需要权限```131```
* 可能需要权限```20```
#### 请求数据
~~~
{
"fun":"getStrangerInfo",
"qq":10001,
"cache":true
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```qq``` | number | - | QQ号 |
| ```cache``` | bool | ```true``` | 使用缓存，```true```/使用，```false```/不使用 |
#### 响应数据
~~~
{
"status":0,
"result":{
"qq":10001,
"gender":0,
"old":0,
"name":"pony",
"headimg":"http://q2.qlogo.cn/g?b=qq&k=Vjic48anMfN6ovAxw4eN94w&s=100&t=1483281655",
"level":37
}
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | object | QQ信息 |
| ```result.qq``` | number | QQ号 |
| ```result.gender``` | int | 性别，```0```/男，```1```/女，```255```/未知 |
| ```result.old``` | int | 年龄 |
| ```result.name``` | string | 昵称 |
| ```result.headimg``` | string | 头像链接 |
| ```result.level``` | int | QQ等级 |
### ```getStrangerInfo_V2```「取陌生人信息」
#### 说明
* 需要权限```131```
* 可能需要权限```20```
* 如果部分信息为空，可能是对方设置了可见权限。
#### 请求数据
~~~
{
"module":"api",
"fun":"getStrangerInfo_V2",
"qq":10001,
"cache":true
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```qq``` | number | - | QQ号 |
| ```cache``` | bool | ```true``` | 使用缓存，```true```/使用，```false```/不使用 |
#### 响应数据
~~~
{
"status": 0,
"result": {
"qq": 10001,
"gender": 1,
"age": 0,
"nick": "pony",
"headimg": "https://thirdqq.qlogo.cn/g?b=sdk&k=Vjic48anMfN6ovAxw4eN94w&s=100&t=1483281655",
"level": 44,
"birthday": {
"day": 0,
"month": 0,
"year": 0
},
"college": "",
"company": "",
"constellation": "天蝎座",
"email": "",
"hometown": {
"area": "",
"city": "",
"country": "",
"state": ""
},
"location": {
"area": "",
"city": "",
"country": "",
"state": ""
},
"occupation": "",
"personal": ""
}
}
~~~
##### 字段说明
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result``` | object | QQ信息 |
| ```result.qq``` | number | QQ号 |
| ```result.gender``` | int | 性别，```0```/男，```1```/女，```255```/未知 |
| ```result.age``` | int | 年龄 |
| ```result.nick``` | string | 昵称，可能存在部分HTML符号(如` `) |
| ```result.headimg``` | string | 头像链接 |
> 以下信息为提供Cookies，并且Cookies有效的情况下可以获取到的
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| ```result.level``` | int | QQ等级 |
| ```result.birthday``` | object | 生日信息 |
| ```result.birthday.day``` | int | 日期 |
| ```result.birthday.month``` | int | 月份 |
| ```result.birthday.year``` | int | 年份 |
| ```result.college``` | string | 学校 |
| ```result.company``` | string | 公司 |
| ```result.constellation``` | string | 星座 |
| ```result.email``` | string | 电子邮箱 |
| ```result.hometown``` | object | 家乡信息 |
| ```result.hometown.country``` | string | 家乡所在国家 |
| ```result.hometown.state``` | string | 家乡所在省份 |
| ```result.hometown.city``` | string | 家乡所在城市 |
| ```result.hometown.area``` | string | 家乡所在区县 |
| ```result.location``` | object | 所在地信息 |
| ```result.location.country``` | string | 所在国家 |
| ```result.location.state``` | string | 所在省份 |
| ```result.location.city``` | string | 所在城市 |
| ```result.location.area``` | string | 所在区县 |
| ```result.occupation``` | string | 职业 |
| ```result.personal``` | string | 个人说明，可能存在部分HTML符号(如`<br>`) |
### ```getRunningInfo```「取运行信息」
#### 请求数据
~~~
{
"module":"api",
"fun":"getRunningInfo"
}
~~~
#### 响应数据
~~~
{
"status": 0,
"result": {
"environment": {
"system": {
"platform": "windows"
},
"platform": {
"name": "coolq",
"branch": "pro"
},
"plugin": {
"error": false,
"vrsion": "2.1.4.0",
"edition": 656
}
},
"state": {
"online": true,
"runTime": 64
}
}
}
~~~
##### 字段说明
| 字段名 | 类型 | 可能值 | 说明 |
| --- | :-: | :-: | --- |
| ```result``` | object | - | 运行信息 |
| ```result.environment``` | object | - | 运行环境信息 |
| ```result.environment.system``` | object | - | 系统信息 |
| ```result.environment.system.platform``` | string | `windows` / `wine` | 系统平台 |
| ```result.environment.platform``` | object | - | 机器人平台信息 |
| ```result.environment.platform.name``` | string | `coolq` | 平台名称 |
| ```result.environment.platform.branch``` | string | `air` / `pro` | 平台分支 |
| ```result.environment.plugin``` | object | - | 插件信息 |
| ```result.environment.plugin.error``` | bool | - | 获取版本信息是是否发生错误 |
| ```result.environment.plugin.version``` | string | - | 插件版本 |
| ```result.environment.plugin.edition``` | int | - | 内部版本号 |
| ```result.state``` | object | - | 运行状态 |
| ```result.state.online``` | bool | - | 机器人QQ是否在线 |
| ```result.state.runTime``` | int | - | 运行时间，单位：`秒` |
