WebQQ协议 3.0

WebQQ协议 3.0

检测验证码

提交方式

GET

提交地址

https://ssl.ptlogin2.qq.com/check?uin=313493902&appid=1003903&js_ver=10060&js_type=0&login_sig=TjOTtaaRqQFSe48i5CvfSqpYEoxuK3WRpPG4*s8tN8MwQf9OD-1H8kxAEpsFETOo&u1=http%3A%2F%2Fweb2.qq.com%2Floginproxy.html&r=0.20044017277841014

注释

uin=QQ号

提交数据

POST专用

返回数据

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

获取验证码

提交方式

GET

提交地址

https://ssl.captcha.qq.com/getimage?aid=1003903&r=0.6246553881923165&uin=313493902

注释

uin=QQ号

提交数据

POST专用

返回数据

验证码字节集

一级登录

提交方式

GET

提交地址

https://ssl.ptlogin2.qq.com/login?u=313493902&p=EAF15E16E6A1C1FBA6A8C19EA24E50EB &verifycode=ME82&webqq_type=10&remember_uin=1&login2qq=1&aid=1003903&u1=http%3A%2F%2Fweb2.qq.com%2Floginproxy.html%3Flogin2qq%3D1%26webqq_type%3D10&h=1&ptredirect=0&ptlang=2052&daid=164&from_ui=1&pttype=1&dumy=&fp=loginerroralert&action=3-60-105181&mibao_css=m_webqq&t=1&g=1&js_type=0&js_ver=10060&login_sig=KEbQayQQ43IwVBEsCKg12ja-YmRWXDms*fSzyURyn45DJz4d7D18KdijUufRz4re

注释

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

提交数据

POST专用

返回数据

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

注释

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

二级登录

提交方式

POST

提交地址

http://d.web2.qq.com/channel/login2

提交数据

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

提交地址

http://s.web2.qq.com/api/get_user_friends2

提交数据

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

提交地址

http://s.web2.qq.com/api/get_group_name_list_mask2

提交数据

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

提交数据

http://s.web2.qq.com/api/get_friend_info2?tuin=313493902&verifysession=&code=&vfwebqq=d59b16c47326423d0620c516b0221d37f6dcb666930eaa428efd758519f0fcc93c5b2337c19b550e&t=1387089573565

注释

uin=临时QQ号（此号码每次登录都不同），vfwebqq=二级登录时返回的数据里包含这个值。（点击跳转），t=13位的时间戳,也可以设置为固定值。

提交数据

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

提交地址

http://s.web2.qq.com/api/get_group_info_ext2?gcode=1017425651&vfwebqq=d59b16c47326423d0620c516b0221d37f6dcb666930eaa428efd758519f0fcc93c5b2337c19b550e&t=1387094072987

注释

gcode=群代码（在获取群那一步返回的数据里包含这个值），vfwebqq=二级登录时返回的数据里包含这个值（点击跳转），t=13位的时间戳,也可以设置为固定值

提交数据

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

提交地址

http://face1.web.qq.com/cgi/svr/face/getface?cache=0&type=11&fid=0&uin=714185040&vfwebqq=d59b16c47326423d0620c516b0221d37f6dcb666930eaa428efd758519f0fcc93c5b2337c19b550e

注释

uin=临时QQ号（此号码每次登录都不同），vfwebqq=二级登录时返回的数据里包含这个值。（点击跳转）

提交数据

POST专用

返回数据

头像字节集

uin转QQ号

提交方式

GET

提交地址

http://s.web2.qq.com/api/get_friend_uin2?tuin=714185040&verifysession=&type=1&code=&vfwebqq=d59b16c47326423d0620c516b0221d37f6dcb666930eaa428efd758519f0fcc93c5b2337c19b550e&t=1387091571894

注释

tuin=临时QQ号（此号码每次登录都不同），vfwebqq=在二级登录时返回的数据里包含了这个值（点击跳转），t=13位的时间戳,也可以设置为固定值。

提交数据

POST专用

返回数据

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

注释

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

更改状态

提交方式

GET

提交地址

http://d.web2.qq.com/channel/change_status2?newstatus=away&clientid=93795904&psessionid=8368046764001d636f6e6e7365727665725f77656271714031302e3133392e372e313630000039e1000000c7036e04008e89af126d0000000a403678365232533935546d00000028ded0d5f9f8a09fababb28c8d65b9cfa1cb3a08ae920c265803fe193059319fe81d44c3e8bcda40cc&t=1387092689637

注释

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

注释

psessionid=二级登录时返回的数据里包含这个值。（点击跳转），t=13位的时间戳,也可以设置为固定值。

提交数据

POST专用

返回数据

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

获取群共享

提交方式

GET

提交地址

http://qun.qzone.qq.com/cgi-bin/group_share_list?uin=313493902&groupid=30098304&bussinessid=0&r=0.12771667958040944&charset=utf-8&g_tk=884254844

注释

uin=当前登录的QQ号，groupid=真实群号（注意不是群ID），g_tk=一级登录时要求记录的值。（点击跳转）

提交数据

POST专用

返回数据

一个包含群共享列表数据的JSON（点击跳转）

获取文件下载地址

提交方式

GET

提交地址

http://qun.qzone.qq.com/cgi-bin/group_share_get_downurl?uin=313493902&groupid=30098304&pa=%2F102%2Ffb9d62a1-7b83-48bc-b101-8c7405d06e88&r=0.8392674616756668&charset=utf-8&g_tk=884254844

注释

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

pa=文件共享路径。（点击跳转）

g_tk=一级登录时要求记录的值。（点击跳转）

提交数据

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

注释

md5、sha、sha3=都是文件的校验值，sip=文件下载IP，url=文件下载链接。

下载共享文件

提交方式

GET

提交地址

http://disk.sz.ftn.qq.com/ftn_handler/368cc39ab256c5725a2e6bba653ad40f1bbdde7bf36db3807f5ed34128c044ea43be25edb95d93d807da11613d62ef7aa1b34f4c2bc93055f7142197f5990fed/2007625711225305.ec

注释

http://disk.sz.ftn.qq.com/ftn_handler/上一步取到的"url"的值/要下载的文件名。

提交数据

POST专用

返回数据

返回下载字节集，直接保存即可。