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 | - | 運行時間，單位：`秒` |
