WebQQ协议 3.0-白红宇

WebQQ协议 3.0

阅读量：6505 次

发布时间：2019-06-24

本文共 4927 字，大约阅读时间需要 16 分钟。

WebQQ协议 3.0

检测验证码

提交方式

GET

提交地址

注释

uin=QQ号

提交数据

POST专用

返回数据

ptui_checkVC('1','3yMT7Ymt9CpEOnCaHcIQf0gbydPJhD5S','\x00\x00\x00\x00\x01\xde\x5a\x8e');

获取验证码

提交方式

GET

提交地址

注释

uin=QQ号

提交数据

POST专用

返回数据

验证码字节集

一级登录

提交方式

GET

提交地址

注释

u=QQ号，p=MD5处理后的密码

提交数据

POST专用

返回数据

返回数据":{ptuiCB('3','0','','0','您输入的帐号或密码不正确，请重新输入。', '313493901');

注释

在返回的Cookies里分别找到名为"ptwebqq"、"skey"的值,把它们记录下来。其中"skey"的值调用"getGTK"命令获得一个9位数，如:"816740399"。这个数在操作群和空间时会用到。

二级登录

提交方式

POST

提交地址

提交数据

r={"status":"online","ptwebqq":"7a97842b8cb3891fb24db49d48de2f60faeed37886f55a9ede0a2bdb90a8b93a","passwd_sig":"","clientid":"20110104","psessionid":null}&clientid=20110104&psessionid=null

注释

status=登录状态，在线=online，Q我吧=callme，离开=away，忙碌=busy，勿扰=silent，隐身=hidden，离线=offline

注释

ptwebqq=在一级登录是返回的Cookies里包含这个值

返回数据

{"retcode":0,"result":{"uin":313493902,"cip":3072499104,"index":1075,"port":24154,"status":"online","vfwebqq":"d59b16c47326423d0620c516b0221d37f6dcb666930eaa428efd758519f0fcc93c5b2337c19b550e","psessionid":"D2C54FC50EE4D0D5A0E2DBEF4540FF1C59A82381877718082A4F76D7949E9B270F2DF977","user_state":0,"f":0}}

注释

uin=QQ号，status=当前登录状态，vfwebqq=将这个值记录下来，接下来的操作都会用到。psessionid=同vfwebqq，记录下来。

获取好友

提交方式

POST

提交地址

提交数据

r={"h":"hello","hash":"015757EC02C602C5","vfwebqq":"d59b16c47326423d0620c516b0221d37f6dcb666930eaa428efd758519f0fcc93c5b2337c19b550e"}

注释

vfwebqq=在二级登录时返回的数据里包含了这个值。

返回数据

{"retcode":0,"result":{"friends":[{"flag":0,"uin":2039993158,"categories":0}],"marknames":[{"uin":151052132,"markname":"没毛的草","type":0}],"categories":[{"index":0,"sort":0,"name":"好友"}],"vipinfo":[{"vip_level":1,"u":2039993158,"is_vip":1}],"info":[{"face":477,"flag":298320386,"nick":"飞翔的企鹅","uin":3554660037}}]}}

注释

friends=好友，marknames=好友备注，categories=好友分组，vipinfo=vip信息，info=好友信息。

获取群

提交方式

POST

提交地址

提交数据

r={"vfwebqq":"d59b16c47326423d0620c516b0221d37f6dcb666930eaa428efd758519f0fcc93c5b2337c19b550e"}

注释

vfwebqq=在二级登录时返回的数据里包含了这个值。

返回数据

{"retcode":0,"result":{"gmasklist":[{"gid":1000,"mask":0}],"gnamelist":[{"flag":17825793,"name":"易语言","gid":3525067094,"code":1017425651}],"gmarklist":[]}}

注释

gmasklist=群代号列表，gnamelist=群名称列表，gmarklist=群标志列表，code=临时群号（获取群资料是要用到）。

获取详细资料

提交方式

GET

提交数据

注释

提交数据

POST专用

返回数据

{"retcode":0,"result":{"face":522,"birthday":{"month":11,"year":2010,"day":30},"occupation":"","phone":"","allow":0,"college":"","uin":313493902,"constel":11,"blood":0,"homepage":"","stat":20,"vip_info":0,"country":"中国","city":"江门","personal":"我以为小鸟飞不过沧海","nick":" ","shengxiao":3,"email":"313493902@qq.co","province":"广东","gender":"male","mobile":"130********"}}

注释

face=头像标志，birthday=生日，occupation=职业，phone=电话，uin=临时QQ号（此号码每次登录都不同），constel=星座（1-12），blood=血型，homepage=主页，country=国家，city=城市，personal=个人说明，nick=昵称，shengxiao=生肖（1-12），email=邮箱，province=省份，gender=性别（male-男，female-女），mobile=手机。

获取群资料

提交方式

GET

提交地址

注释

提交数据

POST专用

返回数据

{"retcode":0,"result":{"stats":[{"client_type":41,"uin":313493902,"stat":30}],"minfo":[{"nick":" ","province":"广东","gender":"male","uin":313493902,"country":"中国","city":"江门"},{"nick":"","province":"广东","gender":"unknown","uin":163557181,"country":"中国","city":"江门"}],"ginfo":{"face":0,"memo":"","class":28,"fingermemo":"","code":1017425651,"createtime":1157872426,"flag":17825793,"level":0,"name":"易语言","gid":3525067094,"owner":313493902,"members":[{"muin":313493902,"mflag":8},{"muin":163557181,"mflag":129}],"option":1},"cards":[{"muin":313493902,"card":"易"},{"muin":163557181,"card":" "}],"vipinfo":[{"vip_level":0,"u":313493902,"is_vip":0},{"vip_level":0,"u":163557181,"is_vip":0}]}}

注释

stats=在线成员（client_type=客户端类型），uin=临时QQ号，minfo=群成员（nike=昵称，gender=性别，uin=临时QQ号，country=国家，province=省份，city=城市，）ginfo=群信息（code=临时群号，createtime=创建时间（Unix时间戳），name=群名称，owner=创建人），cards=群名片（muin=临时QQ号，card=名片），vipinfo=vip信息（vip_level=vip等级，u=临时QQ号，is_vip=是否为vip（0=不是，1=是））

获取头像

提交方式

GET

提交地址

注释

提交数据

POST专用

返回数据

头像字节集

uin转QQ号

提交方式

GET

提交地址

注释

提交数据

POST专用

返回数据

{"retcode":0,"result":{"uiuin":"","account":2428099800,"uin":714185040}}

注释

account=QQ号，uin=临时QQ号（此号码每次登录都不同）

更改状态

提交方式

GET

提交地址

注释

newstatus=新状态，在线=online，Q我吧=callme，离开=away，忙碌=busy，勿扰=silent，隐身=hidden，离线=offline

注释

提交数据

POST专用

返回数据

{"retcode":0,"result":"ok"}

获取群共享

提交方式

GET

提交地址

注释

提交数据

POST专用

返回数据

获取文件下载地址

提交方式

GET

提交地址

注释

uin=当前登录的QQ号，groupid=真实群号（注意不是群ID）

提交数据

POST专用

返回数据

_Callback({

"code":0,

"subcode":0,

"message":"",

"default":0,

"data":

{"cookie":"b56cb6f2","dns":"cd.ctfs.ftn.qq.com","ismember":1,"md5":"cccf92a9cf4ff451e134ddd6b4f8440ce5c70d9f","ret":0,"sha":"b46988f98a72888809ce57d6c8bd97b0b56cb6f2","sha3":"cccf92a9cf4ff451e134ddd6b4f8440ce5c70d9f","sip":"182.131.9.231","url":"http://cd.ctfs.ftn.qq.com/ftn_handler/9d06154a801be307c0df49871f5cf2d089ca5dde15fec2934e16dd71668b1bab7fa15a6fc8329606e9b3853315568a163063392537f8fba732c1272187787a39"}}

);