Skip to content

API说明 GET

Jump to bottom
Hstb edited this page Aug 28, 2017 · 1 revision

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"
}

响应数据

{
    "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「取文件信息」

请求数据

{
    "fun":"getFileInfo",
    "source":"ACUvYTAAGAY="
}
参数说明
参数名 类型 说明
source string 文件标识，即插件所提交的参数file

响应数据

{
    "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

请求数据

{
    "fun":"getGroupList"
}

响应数据

{
    "status":0,
    "result":[
        {
            "name":"Zero",
            "group":4639,
            "headimg":"http://p.qlogo.cn/gh/4639/4639/100"
        }
    ]
}
字段说明
字段名 类型 说明
result array 群信息列表
result[i] object 第i+1个群信息
result[i].name string 群名，url编码
result[i].group number 群号
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头像

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

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等级

getMoreGroupHeadimg「批量取群头像」

说明

  • 需要权限20

请求数据

{
    "fun":"getMoreGroupHeadimg",
    "groupList":"41112-123123"
}
参数说明
参数名 类型 默认值 说明
groupList string null 群列表，每个群用-分开，可空，空时表示取所有群的头像链接

响应数据

{
    "status":0,
    "result":[
        {
            "f":"http://thirdqq.qlogo.cn/g?b=sdk&k=ibx1xDias1jg&s=40&t=0",
            "u":140
        },
        {
            "f":"http://thirdqq.qlogo.cn/g?b=sdk&k=VeicEFmPw&s=40&t=45",
            "u":463
        }
    ]
}
字段说明
字段名 类型 说明
result array 头像信息
result[i] object 第i+1个头像信息
result[i].f string 头像链接
result[i].u string 头像对应的群号

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等级

getVersion「取版本信息」

请求数据

{
    "fun":"getVersion"
}

响应数据

{
    "status":0,
    "result":{
        "cq":"air",
        "plugin":"2.1.2(204)"
    }
}
字段说明
字段名 类型 说明
result object QQ信息
result.cq string 酷Q版本，air/pro
result.plugin string 插件版本
Clone this wiki locally