QQ的HTTP接口探究

天云上人

作者：Hackfan
日期：2005.8.21凌晨
8 s6 ^& I3 X: p联系：QQ:106814 Email:hackfan@vip.sina.com

* h+ G. B4 J/ n' F: A+ h+ \１、研究说明
+ [% a! L7 I  F8 M& t/ H' _
　　Tencent在tqq.tencent.com的8000有一个使用HTTP的QQ接口，通过这个接口，可以进行一些基本的操作，如：登陆、登出、改变登陆状态(上线、忙碌、离线、隐身)、添加删除好友、查看好友信息、发送验证信息(接受被加为好友、申请加对方为好友、拒绝被加为好友)、收发用户消息、系统信息。
! E  y2 L9 z1 n
　　目前我研究的是1.1版本的HTTP QQ协议，研究是微程在的成果上进行的，不敢说有什么超越，只不过更为详细和准确。

5 ~& _' l$ A  p  ?２、接口说明：

　　接口位置：tqq.tencent.com:8000
　　通信协议：HTTP
　　数据传输方法：POST
2 a: l: T: T! Q2 B, S! i- E1 z　　HTTP请求格式：
& V/ O& W0 w3 _% [3 z
POST HTTP/1.1
Host: tqq.tencent.com:8000
Content-Type: text/plain; charset=UTF-8
Content-length: 长度
% N5 f* |* S2 N# j" _Connection: close

数据
( M/ Y" C' j- C6 m" P: \% U
　　其中长度为 数据 的长度，数据的格式：
- V8 o" G0 G: F7 S! C/ f/ i　　VER=1.1&CMD=命令&SEQ=标记&UIN=QQ号&....
; U; l) e6 D8 {7 u- X7 ^. G7 ^
　　以上４个参数是每个请求都必有的。其中，VER表示协议的版本，目前为1.1，据说1.2已经出来了，这个乱写的话，服务器返回NULL； CMD为操作的指令，有Login、List、Query_Stat、GetInfo、AddToList、Ack_AddToList、 DelFromList、Change_Stat、GetMsgEx、CLTMSG、Logout；SEQ为当前请求的标记，防止重复发送，可以用当前时间，也可以用随机数；UIN是当前执行操作的QQ号。不过不同的CMD还需要不同的参数，下面我就公布我的研究成果。
9 ^5 T, }! d' u1 {
$ c$ H% U* p$ K2 J３、研究方法：
8 P, e9 b0 r1 |) R' I$ Q
+ u; Y0 ~8 O7 X, f) d　　我对目前网上的资料不够满意，就自己写程序，发送多条相同CMD不同参数的请求，根据服务器的返回，来做判断。感兴趣的朋友可以参考一下，此处可以跳过。
6 G( c. Y/ A+ e, J4 d: N! \　　下面我公布我探测的代码(PHP)：

1. <?
   
2. $uin = "QQ号";
   ) N; v: r6 C3 b2 N" y$ k/ G& ?
3. $pwd = md5("QQ密码");
   
4. 
   
5. //登陆测试
   
6. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=1&LC=9326B87B234E7235";
   
7. //注意：登陆测试不能同时进行，必须等到服务器认为QQ断开了，才能够测试，不然结果不可信
   
8. /*******
   
9. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=0&LC=9326B87B234E7235";
   
10. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=1&LC=9326B87B234E7235";
    
11. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=2&LC=9326B87B234E7235";
    ; ^! Q# l' v! m( Q( N2 \
12. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=3&LC=9326B87B234E7235";
    1 P7 F# n+ E0 p
13. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M6=1&LC=9326B87B234E7235";
    
14. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M6=1&LC=1223423545756679";
    
15. *******/
    3 g: E6 T. f' J
16. 
    
17. 
    
18. //得到好友列表
    
19. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin;
    7 p0 j7 }5 ~# N( M7 k& ?
20. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0";
    
21. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160";
    1 v4 E6 E2 {. z2 x
22. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=0";
    $ }! w: y( `( p: t$ j7 _
23. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=".rand(1,10);
    
24. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=0";
    . J* j- q: F" P6 K# j. @
25. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    ) U1 J# i* @# w4 C" A
26. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    $ l! \& Y9 z) O2 \
27. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    * P/ g* k/ I9 K7 a9 H) f0 M2 e0 N9 }
28. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    
29. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    
30. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    . l# a. b' j- P4 D% V. a. ^' `
31. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    # Q- n. I! T% ?5 C* u7 @- P
32. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    
33. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=106814";
    
34. 
    
35. //得到在线列表
    
36. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin;
    
37. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0";
    
38. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160";
    
39. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=0";
    
40. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=".rand(1,10);
    + J6 }* G0 }7 ?. x
41. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=0";
    0 _& w1 p% k( l) D' l4 L
42. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    
43. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    
44. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    
45. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    
46. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    " L! q+ F/ I' z$ f& A" B1 J9 c
47. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    
48. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    1 l( x* _7 R  m) a( W
49. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    ' l4 T: S; d5 z
50. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=106814";
    
51. 
    4 V0 d+ f) _! y. Z& ~9 \
52. //查看好友信息
    
53. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=0&UN=106814";
    
54. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=1&UN=106814";
    
55. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=2&UN=106814";
    
56. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=3&UN=106814";
    / u, O5 \, k  x! ~3 S: i; O
57. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=4&UN=106814";
    
58. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=5&UN=106814";
    
59. 
    
60. //增加好友
    ! d# u: B1 b2 n) X( l* W( R1 i
61. $poststring[] = "VER=1.1&CMD=AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    7 U8 q2 ?$ Z7 J5 [, o9 \
62. 
    4 }" ^! s5 e/ K5 g" x  A
63. //发送验证
    
64. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=0&RS=TEST";
    / T, W3 I( M% Z9 B" T) p, z
65. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=1&RS=TEST";
    
66. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=2&RS=TEST";
    ' V" N6 j& l. f, `0 |( w! _2 Z
67. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=3&RS=TEST";
    7 `  G+ X, b2 h! I
68. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=4&RS=TEST";
    9 h/ A/ m: X( X$ x7 ~9 K% t3 {9 F9 \! i0 K
69. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=5&RS=TEST";
    
70. 
    
71. //删除好友
    / L6 L; b& X) @! n
72. $poststring[] = "VER=1.1&CMD=DelFromList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    
73. 
    $ A# `8 A1 {4 `. Q, q
74. //改变状态
    - R$ A& h! t. E4 s( L' ?
75. for($i=0;$i<=60;$i=$i+5)
    6 O6 J6 |" v* P8 U/ M( \$ e0 b
76. {
    
77. $poststring[] = "VER=1.1&CMD=Change_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&ST=".$i;
    5 q, E- v: t0 R1 N' r
78. }
    
79. 
    
80. //获得消息
    ( }/ t! P% Y8 K
81. $poststring[] = "VER=1.1&CMD=GetMsgEx&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    
82. 
    ( V9 R; s' f3 v" g+ x# g: z
83. //发送消息
    6 _9 g7 U5 K' T1 O, l% R; B
84. $poststring[] = "VER=1.1&CMD=CLTMSG&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&MG=TEST";
    7 H4 E: w8 E8 C" y; t2 o
85. 
    
86. //登出
    * \6 x1 C# y2 K5 R# N% N7 O9 c
87. $poststring[] = "VER=1.1&CMD=Logout&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    
88. 
    
89. $file = fopen("p.txt","w");
    ( t4 l4 ]. }5 s( X. J1 X( x! |0 c
90. 
    - W3 Y# g6 @  r( i
91. foreach($poststring as $k=>$v)
    
92. {
    $ y! X0 b& R! i$ L7 A5 G# F9 r  R
93. ss_timing_start();
    
94. $fp = fsockopen('tqq.tencent.com', '8000', $errno, $errstr, $timeout = 10);  
    0 k! r) e% l3 K) W+ F. g! F/ n% N
95. 
    3 u3 U* o. [% u
96. if(!$fp){  
    
97. //error tell us  
    
98. $content = $k.chr(13).chr(10)."ERROR:$errstr ($errno)";  
    6 @0 D! r: Y# X0 Y/ a
99.    
    - ]/ l- n2 F7 q9 V6 F) ~
100. }else{  
     + W" m, B& D5 q8 a) P$ q8 e; |. ^
101. 
     
102.   //send the server request  
     
103.   fputs($fp, "POST HTTP/1.1\r\n");  
       ~; K: M  y  G/ x' N7 j8 r
104. //  fputs($fp, "Host: $host\r\n");  
     
105. //  fputs($fp, "Content-type: application/x-www-form-urlencoded\r\n");  
     
106.   fputs($fp, "Content-length: ".strlen($v)."\r\n");  
     4 E1 b* [* M0 g7 c7 s
107.   fputs($fp, "Connection: close\r\n\r\n");  
     
108.   fputs($fp, $v . "\r\n\r\n");  
     
109. 
     ) b; [# p2 o' [+ o$ t, U# s
110.   //loop through the response from the server  
     * W6 K2 K: S  F9 t
111.   $res = "";
     
112.   while(!feof($fp)) {  
       k- `4 K/ w: `* K7 v2 L6 N7 p
113.   $res .= fgets($fp, 4096);  
     
114.   }  
     
115.   //close fp - we are done with it  
     : ]( W, U' G7 h: X. v  p- m; o
116.   fclose($fp);  
     
117. 
     - {# B) ~6 u$ t* }5 \% c
118.   $content = $v.chr(13).chr(10).$res;
     
119. }  
     
120. ss_timing_stop();  
     
121. $content .= chr(13).chr(10)."Time: ".ss_timing_current().chr(13).chr(10)."--------------------------------------".chr(13).chr(10);
     7 o' g% x+ Z6 M
122. fputs($file,$content);
     $ u; z4 }( r" w1 `" Z" `+ ~
123. }
     
124. fclose($file);
     
125. ?>
     0 U* ?. L+ Q& F. _+ P; D
126. <?
     , _7 J' k4 m3 b, `4 r( x! C9 j
127. function ss_timing_start ($name = "default") {  
     - O% x. q& @2 B# ]" J% h. J& P
128. global $ss_timing_start_times;  
     
129. $ss_timing_start_times[$name] = explode(' ', microtime());  
     
130. }  
     8 k  L  e' H$ B4 c
131. function ss_timing_stop ($name = "default") {  
     
132. global $ss_timing_stop_times;  
     
133. $ss_timing_stop_times[$name] = explode(' ', microtime());  
     6 F2 D/ Y+ I. h# _+ V( P3 q* ~* N: i
134. }  
     
135. function ss_timing_current ($name = "default") {  
     
136. global $ss_timing_start_times, $ss_timing_stop_times;  
     
137. if (!isset($ss_timing_start_times[$name])) {  
     ) |, ?' n/ }9 e
138. return 0;  
     / r/ c5 F5 i2 l: s+ S$ P
139. }  
     2 K( |8 X, d+ [
140. if (!isset($ss_timing_stop_times[$name])) {  
     
141. $stop_time = explode(' ', microtime());  
     
142. }  
     4 Q2 v; \% Y' g% V3 I% L
143. else {  
     & _4 {$ y: L3 m1 r5 `' Y
144. $stop_time = $ss_timing_stop_times[$name];  
     
145. }  
     
146. $current  =  $stop_time[1]-$ss_timing_start_times[$name][1];  
     7 N, F6 X7 H$ _) c. a0 x
147. $current += $stop_time[0]-$ss_timing_start_times[$name][0];  
     
148. return $current;  
     
149. }  
     
150. ?>

复制代码

４、研究成果：

(1).登陆
　　说明：在你做任何其他操作以前，你必须登陆。只有在登陆以后，你的其他指令才有可能被正确执行(返回RES=0)，不然服务器会返回RES= 20，不过有个例外，就是logout。当你成功登陆以后，服务器就会根据你的IP*和参数中的UIN来验证身份。一台电脑可以同时登陆多个QQ，互不影响，就是因为有参数UIN。
8 [) U/ T5 y/ \+ D, W  ]# P. L( a9 g　　*至于我能够确定服务器是通过IP来验证的，是因为服务器不可能通过我的请求获得其他信息了^_^

: V) O+ p& Z+ j* Q: W  Q　　提交数据：VER=1.1&CMD=Login&SEQ=标记&UIN=QQ号&PS=QQ密码&M5=1&LC=9326B87B234E7235
( f1 i6 d. i& d* k　　说明：QQ密码是通过md5加密的字符串，在PHP中可以直接用md5()进行加密；
　　　　　M5这个参数的作用还不清楚，但最好为1。
　　　　　LC这个参数有点神秘，不能有丝毫改动，不然服务器就没有响应(没有响应就是返回NULL)。
: U7 b& Z, J" S- X$ \
6 G! o! A" m8 p　　返回：VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=0&RS=0&HI=60&LI=300(成功)
. n3 \" k/ w+ @; e; O% e  T( l; w　　　　　VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=0&RS=1&RA=密码错误(密码错误)
/ X# K7 I+ ?* d) J) Z# K) X7 v　　　　　VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=5(QQ号非法，如100)
) c( A3 y) K1 a6 `　　　　　NULL(UIN为字符、PS为空、LC错误)

(2).得到好友列表
　　提交数据：VER=1.1&CMD=List&SEQ=标记&UIN=QQ号&TN=160&UN=0
　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响

7 X4 V4 n# h' H" A4 g: g　　返回：VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=0&FN=9(当TN=0或没有TN参数时，FN表示好友数)
　　　　　VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=0&FN= 1&SN=9&UN=3814526,...,(当TN存在且非0时，FN=1，SN表示好友数，UN为好友列表，用","分割)
　　　　　VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、TN、UN为字符)

(3).得到在线好友列表
　　提交数据：VER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号&TN=50&UN=0
+ i1 R) _# c) O1 N+ y: K　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响
  P5 z8 X: t5 a. b' }! X/ A
　　返回：VER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES= 0&FC=0,&FN=1&SN=1&ST=10,&UN=106814,&NK=Hackfan  好,(当TN存在且非0时，FN=1，SN表示在线好友数，FC、ST、UN、NK的值用','分割，分别表示头像、状态、号码、昵称)
　　　　　VER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、TN、UN为字符)
　　说明：FC为QQ头像的的ID，如的头像ID为270，那么其头使用的图片为91.bmp,其算法为ID/3+1；
7 h  }+ g+ X5 b7 a. D8 S0 b　　　　　ST为QQ用户的状态，10为上线，20为离线(或隐身)，30为忙碌；

　　特别说明：当参数TN=0或不存在时，服务器返回：
; N' I  I0 {" C" N; pVER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号
6 k2 K1 d* E( d& ]4 y3 G: eHTTP/1.1 200 OK
Server: tencent imserver/1.0.0
- z5 [" E: r5 J6 pContent-Type: text/plain; charset=UTF-8
7 I" R0 q. a+ p. x* eContent-Length: 56

! g9 W( q* _( A. n) mVER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FN=1
7 V6 b9 F0 [. v$ z; E' CHTTP/1.1 200 OK
- N7 g8 k3 n- s8 I% W% `% `" B4 qServer: tencent imserver/1.0.0
Content-Type: text/plain; charset=UTF-8
5 H; `& U1 ~0 `9 u+ {! YContent-Length: 77

( @, F0 y6 N5 @1 T+ PVER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FC=&FN=1&SN=0&ST=&UN=&NK=
6 K' z$ T6 w* B0 n4 w' g9 o9 }　　返回了２次，第一次的结果中，FN为在线好友数，第二次返回的数据基本没用。

(4).查看好友信息
　　提交数据：VER=1.1&CMD=GetInfo&SEQ=标记&UIN=QQ号&LV=查询类型&UN=被查询QQ号码
: X/ b- ?% a2 j$ V( z* i　　说明：LV=0,1为精简查询，LV=2为普通查询，LV>=3为详细查询

　　返回：VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=0&LV=0&UN=106814&NK=Hackfan 好(精简查询)
- I7 X4 s$ a# ?% ~　　　　　VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=0&AD =地址&AG=19&EM=hackfan@qq.com&FC=0&HP=http: //blog.hackfan.net&JB=学生
&LV=2&PC=邮编&PH=电话&PR= The guy is updating to .NET Frameword......&PV=江苏&RN=胡吉阳&SC= 毕业院校&SX=0&UN=106814&NK=Hackfan  
好(普通查询)
　　　　　VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=0&AD =地址&AG=19&BT=2&CO=6&CT=苏州&CV=%01&CY=中华人民共和国
&EM=hackfan@qq.com&FC=0&HP=http://blog.hackfan.net&ID =-&JB=学生&LV=3&MO=136********&MT=0&MV=&PC=邮编& PH=电话&PR=The guy is  
updating to .NET Frameword......&PV=江苏&RN=胡吉阳&SC=毕业院校&SH=3&SX=0&UN=106814&NK=Hackfan 好(详细查询)
; |3 A* k- @. q4 D2 J* O0 p3 U　　　　　VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
4 U" A6 P$ Z* E  r4 ]/ x4 \( R　　　　　NULL(UIN、LV、UN为字符)

　　说明：AD为联系地址
& I0 s5 B6 |. ^  a* N7 t0 `　　　　　AG为年龄
　　　　　BT为血型
' F) i2 p9 Q2 Q2 z　　　　　CO为星座
　　　　　CT为城市
　　　　　CV为未知*
+ H- N, F; a0 S1 E# S. T- [2 N' ]　　　　　CY为国家
2 s3 ^/ X+ P0 o/ l) s　　　　　EM为Email
! d+ I, H2 z: l4 R0 [　　　　　FC为头像
　　　　　HP为网站
$ Z: \) r, X( Q, {3 d3 S　　　　　ID为未知
　　　　　JB为职业
　　　　　LV为查询代码(就是发送的LV)
4 t7 X1 }  N" H1 w/ l　　　　　MO为移动电话
# w1 v3 l0 u: W  y　　　　　MT为未知
6 X7 s( r; O2 n2 z　　　　　MV为未知
6 ]% T- \- v5 d1 d　　　　　PC为邮编
　　　　　PH为联系电话
2 Y6 ]0 y- m( G+ |5 W　　　　　PR为简介
　　　　　PV为省
( G/ R7 n' O+ M　　　　　RN为真实姓名
2 F; ~! h7 R/ q　　　　　SC为毕业院校
　　　　　SH为生肖
　　　　　SX为性别
　　　　　UN为QQ号
　　　　　NK为昵称
' e9 A9 I2 F9 `! F2 y; ^
　　　　　血型：0 => '',
　　　　　　　　1 => 'A型',
5 N7 c0 e, f. ]: l0 M, Y- ?; G　　　　　　　　2 => 'B型',
( e2 Z7 K3 R  e% z3 M+ W6 q" l　　　　　　　　3 => 'O型',
　　　　　　　　4 => 'AB型',
9 i& _4 h' P. g/ q: M　　　　　　　　5 => '其他'


　　　　　星座：0 => '',
　　　　　　　　1 => '水瓶座',
( l5 ]+ i6 |1 T* u' E+ ~　　　　　　　　2 => '双鱼座',
　　　　　　　　3 => '牡羊座',
! f+ M4 _1 l$ Z0 H0 Q5 P　　　　　　　　4 => '金牛座',
9 B3 `; m1 l9 H& `) F+ c　　　　　　　　5 => '双子座',
　　　　　　　　6 => '巨蟹座',
　　　　　　　　7 => '狮子座',
$ Q9 P5 r$ u* k. c* u. d1 Y, ]　　　　　　　　8 => '座',
　　　　　　　　9 => '天秤座',
　　　　　　　　10 => '天蝎座',
0 t: p! X) n3 w8 S4 s8 P5 p　　　　　　　　11 => '射手座',
6 W: B) {7 s6 P1 H& }4 J3 x　　　　　　　　12 => '摩羯座'
. J8 M; F, t2 T( a: t( Z
　　　　　生肖：0 => '',
. e& |! W2 n, R+ Z) @　　　　　　　　1 => '鼠',
　　　　　　　　2 => '牛',
　　　　　　　　3 => '虎',
　　　　　　　　4 => '兔',
　　　　　　　　5 => '龙',
8 r% x( k/ p# c9 n　　　　　　　　6 => '蛇',
* W$ j3 q, R. z, i: i　　　　　　　　7 => '马',
, m) o! q0 P& N' {4 k6 x! o  q' \　　　　　　　　8 => '羊',
8 d, f! ?( u# B  ?  \6 ]　　　　　　　　9 => '猴',
　　　　　　　　10 => '鸡',
　　　　　　　　11 => '狗',
- |1 ~1 M& S( O3 W8 `　　　　　　　　12 => '猪'

　　　　　性别：0 => '男',
8 z+ h6 H) B% T: z8 ^6 s5 ^: _　　　　　　　　1 => '女'

(5).增加好友
　　提交数据：VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号

　　返回：VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=0&UN=对方QQ号(允许被加为好友，此时他已经是你的好友)
6 q) R. U; l; i$ K5 x+ m　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=1&UN=对方QQ号(需要验证)
2 j4 f' U% N) ~2 U4 ?　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=2&UN=对方QQ号(决绝被加为好友)
　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、UN为字符)

  t6 j4 Y9 S! p1 t  q& H(5).发送验证
9 S2 V! G- h5 u* h) y) y3 m　　说明：1、如果你加对方为好友，你需要发送验证
/ h1 `$ M% B( z7 l, T) u( d　　　　　2、对方加你为好友，发送了验证，你要通过或者拒绝
0 U6 P" a& ~9 w% G1 C, g0 P. r　　　　　这2种情况需要发送验证消息
6 d* m( g! m& ]# Z
　　提交数据：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号&CD=验证类型&RS=理由
　　说明：CD为0表示“通过验证”，CD为1表示“拒决加为对方为好友”，CD为2表示“为请求对方加为好友”。

　　返回：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=0(成功)
　　　　　VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=3(*)
7 j9 v5 V$ P8 E3 y4 z% q; w　　　　　VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、UN、CD为字符，RS为非UTF-8字符)
: e# S7 c' A" @3 o& w　　*如果服务器返回RES=3，那么这次对话的响应时间在20s。当发送验证请求的时候，必须连发2次(请求内容不必一样)，其中一条RES=3，对方收不到，一条RES=0，对方能够收到。当CD>=3时，RES=3，响应时间20s。
7 N) E2 ], Y5 g6 z+ O5 X( F/ Q
+ j. x# j5 a; V  q' {4 W' j(6).删除好友
; d6 d# |. W; P" l2 n$ i2 O　　提交数据：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&UN=删除的QQ号
3 Z3 d# A, t+ b) {0 U) s9 {  r
　　返回：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=0&(成功)
8 Y- k7 v2 L( {" B3 Y- n# \　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=3(响应时间30s，重复发送的后果)
$ R: D1 z8 J9 `" y3 ~　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
+ Q7 F& R/ r: F5 v　　　　　NULL(UIN、UN为字符)
1 M" N! f3 Y& Z# m  J. i  a) S
5 ~! P+ S8 Q/ B! q3 b/ C6 S* H(7).改变状态
; P" |( c* C3 |5 [9 E5 k- b' R　　提交数据：VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&ST=状态代码
* S1 j* C/ C. S, I3 X　　说明：状态代码：10为上线，20为离线，30为忙碌，40为隐身，其他视为非法

1 P3 h5 B) O& E5 `　　返回：VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=0&(成功)
　　　　　VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=3(失败，原因不明，响应时间20s，可能是过于频繁的改变状态引起的)
* P6 c; j6 {$ K0 C1 h! ~9 E: v5 B　　　　　VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN为字符，ST非法)

　　特别说明：如果你改变好友，将会给所有好友发送一条系统信息，内容就是状态代码；如果隐身，发送的状态代码为20，表示离线。
　　　　　　　同理，当你的好友改变状态，你也会收到一条系统信息。
/ _& ^+ c1 x1 T, y, z7 V$ j/ R
  B6 c6 M8 L: S* Z(9).获得消息
　　提交数据：VER=1.1&CMD=GetMsgEx&SEQ=标记&UIN=QQ号
' U. q$ e, k: O' N) W& C8 t# e
+ F' T7 x0 P- a　　返回：VER=1.1&CMD=GETMSGEX&SEQ=标记&UIN=QQ号&RES=0& MN=4&MT=99,99,99,9,&UN=36791785,99833581,99833581,106814,&MG= 20,30,10,hi ,(MN表示信息数量，MT、UN、MG的值用","分割，分别表示消息类型、发送人号码、消息内容)
4 I! F) Y; W8 d7 z7 s　　　　　VER=1.1&CMD=GETMSGEX&SEQ=标记&UIN=QQ号&RES=0&MN=0&MT=&UN=&MG=(表示没有信息)
　　　　　VER=1.1&CMD=GETMSGEX&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
: |9 J2 N9 P, z3 A% A8 C　　　　　NULL(UIN为字符)
7 x* e+ E: D* V　　说明：关于MT：
8 p/ Y8 _8 R' l2 N2 ^/ P　　　　　　　9为用户消息，99为系统消息，2为请求信息，3为通过验证，4为拒绝被加好友
　　　　　关于MG：
　　　　　　　当MT=9时，MG为用户发送的消息内容
# C: k$ U- Z$ a& m　　　　　　　当MT=99时,
0 `) m3 x* ]* ^2 _# h3 z　　　　　　　　　MG=10(QQ_STATUS_ONLINE)表示对方上线
$ i+ Y5 E1 y5 ]1 G　　　　　　　　　MG=20(QQ_STATUS_OFFLINE)表示对方下线
5 _9 s  m3 Z2 \) X' P' F' v( V1 N4 |8 E　　　　　　　　　MG=30(QQ_STATUS_BUSY)表示对方进入忙碌状态
　　　　　　　当MT=2时，MG为对方请求你验证的信息
　　　　　　　当MT=3时，表示对方通过你的验证
　　　　　　　当MT=4时，MG为对方拒绝你理由
- c4 V* \5 F, J
5 I+ U( W2 T3 P: X(10).发送消息
4 Q/ U6 |3 C( ~. ~1 @  |　　提交数据：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&UN=对方QQ号&MG=发送内容

: {, \2 z1 i/ }7 L) Z, x* E　　返回：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=0&(成功发送，对方不一定能收到哦)
$ }% c. u2 P1 S8 c$ L　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=3(发送过快)
3 B) t; a$ Z' {' y1 m　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、UN为字符，MG含非UTF-8字符)
　　说明：1、当你发消息时，以下情形对方可能看不到(其实是收到了，QQ不提示)你发送的消息：
' B9 f% o5 K. D9 H　　　　　　　你俩互为陌生人，且对方没有和你说过话
4 b# _5 ^2 A3 D) O! t+ J　　　　　　　你在他的陌生人列表里，并且他没有和你说过话(没有验证)
3 Z! I7 m! w  L  E/ p/ \　　　　　2、当你过快发送消息时，系统会给你一个惩罚，RES=3，相应时间20s
　　　　　3、当我发送含有小写字母h的信息时，服务器有可能返回NULL

8 E0 `- P- u& Y) ], [' X" F(11).登出
　　提交数据：VER=1.1&CMD=Logout&SEQ=标记&UIN=QQ号
! x! s8 d- c9 t) `
+ w! ~' p) n" u' H& ]　　返回：VER=1.1&CMD=LOGOUT&SEQ=标记&UIN=QQ号&RES=0(成功，好像永远成功的，不管你是否登陆)
# S" Z% m" v$ I3 f　　　　　NULL(UIN为字符)

, B. h( y6 D, _５、总结

　　通过对照以上的接口说明，我开发出了能够实现基本QQ功能的PHP类，它整合了以上所有的接口，使用更方便，可以开发QQ机器人、群发广告程序等。免费获得类的代码请到
　　http://blog.hackfan.net/index.ph ... d=a_20050819_223558
! I4 ^1 V( e: m4 v- v# L& T　　本文撰写时间仓促，难免有误，希望各位不吝赐教
0 J2 N* [  z/ c# p. L. D! W7 z
0 ]' Q9 d" A; B( a: p' `3 g
5 O  X% G/ _! b1 Y+ |3 t. |Trackback: http://tb.donews.net/TrackBack.aspx?PostId=520301