QQ的HTTP接口探究

天云上人

作者：Hackfan
3 b* I$ \# f$ _* a日期：2005.8.21凌晨
联系：QQ:106814 Email:hackfan@vip.sina.com
& y- D/ T+ Z3 }" a* C1 q* b( n
$ l) m. e1 ?, D: @' v! z7 K8 q１、研究说明
3 a% }% k! m5 g3 X
　　Tencent在tqq.tencent.com的8000有一个使用HTTP的QQ接口，通过这个接口，可以进行一些基本的操作，如：登陆、登出、改变登陆状态(上线、忙碌、离线、隐身)、添加删除好友、查看好友信息、发送验证信息(接受被加为好友、申请加对方为好友、拒绝被加为好友)、收发用户消息、系统信息。

　　目前我研究的是1.1版本的HTTP QQ协议，研究是微程在的成果上进行的，不敢说有什么超越，只不过更为详细和准确。

6 v5 q$ W& B8 c0 L& A* l3 S２、接口说明：
) N6 j% Q2 G$ J' ]
4 s" J; k8 D- g: N* p3 y, D　　接口位置：tqq.tencent.com:8000
　　通信协议：HTTP
　　数据传输方法：POST
　　HTTP请求格式：

6 V, ^/ d+ _, `0 @# G' u5 hPOST HTTP/1.1
Host: tqq.tencent.com:8000
Content-Type: text/plain; charset=UTF-8
Content-length: 长度
Connection: close

) ^9 ^( @7 K6 Y数据

　　其中长度为 数据 的长度，数据的格式：
4 u6 }" |( n- ?0 E$ |6 B　　VER=1.1&CMD=命令&SEQ=标记&UIN=QQ号&....
9 x* \" f# x2 q& r
! d2 q: e+ Z; R6 S. B( o　　以上４个参数是每个请求都必有的。其中，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还需要不同的参数，下面我就公布我的研究成果。

6 _5 B) L! C" O, m３、研究方法：

　　我对目前网上的资料不够满意，就自己写程序，发送多条相同CMD不同参数的请求，根据服务器的返回，来做判断。感兴趣的朋友可以参考一下，此处可以跳过。
0 f& c& z: n: c( Z) j) R　　下面我公布我探测的代码(PHP)：

1. <?
   
2. $uin = "QQ号";
   ! V' a# ~/ l. r& X/ n
3. $pwd = md5("QQ密码");
   ! v4 C# }9 E) t
4. 
   0 A7 f) C: {" L; }8 ]) m
5. //登陆测试
   5 D* k  O6 E6 }, L# `3 u
6. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=1&LC=9326B87B234E7235";
   3 z, |2 ~$ d$ T; x7 o+ X6 m9 O
7. //注意：登陆测试不能同时进行，必须等到服务器认为QQ断开了，才能够测试，不然结果不可信
   
8. /*******
   1 ]% Y; v' p/ F/ q1 r
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";
    
12. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=3&LC=9326B87B234E7235";
    
13. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M6=1&LC=9326B87B234E7235";
    6 o  Q, x6 f3 J' ]
14. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M6=1&LC=1223423545756679";
    
15. *******/
    
16. 
    ' r7 q. o- A5 ?- U
17. 
    0 d. ?7 K, K+ N9 @/ ~7 p
18. //得到好友列表
    
19. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin;
    
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";
    $ H+ a0 B0 E6 Q. N# W
22. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=0";
    
23. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=".rand(1,10);
    % C* ]! E8 V2 O% `: A
24. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=0";
    ; {% |1 E" v8 y4 {
25. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    
26. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
      m4 q) \3 w# s
27. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    0 ?6 I3 C4 i9 L. r
28. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    4 g  w+ j8 `1 G8 P+ Y
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);
    
31. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    $ b) Q* M" M- s4 U' p3 a! t: Q
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;
    - }+ p2 g5 ^$ _, {( \& e& v" W
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);
    
41. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=0";
    4 D8 d+ h2 a) M
42. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    $ u3 n" Y+ x  V8 O, }
43. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    , K" J8 g, I+ u. u
44. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    8 @/ H4 M. e- D9 L
45. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    ) ^% ^% Q& C7 h8 L
46. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    8 r. R& {9 }, C# X
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);
    % c# o7 I( B& M- d
49. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    : t& [% H# h9 `/ E- s) n
50. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=106814";
    
51. 
    
52. //查看好友信息
    
53. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=0&UN=106814";
    $ w* y; e$ ?2 c5 c- t4 |- |; z
54. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=1&UN=106814";
    3 M0 |& v( i3 H
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";
    8 w" Y7 Z0 q' D8 o) N/ P7 q! 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";
    % H( Q% Q! m! P5 g' E3 L
59. 
    ! a& Q1 C4 \6 m" h0 w3 u
60. //增加好友
    3 U8 n7 K/ N6 [3 k
61. $poststring[] = "VER=1.1&CMD=AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    
62. 
    
63. //发送验证
    
64. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=0&RS=TEST";
    / @6 {9 D+ f  G" g4 U
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";
    
67. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=3&RS=TEST";
    # G9 ]' [# P( i. ^; z9 }( A
68. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=4&RS=TEST";
    
69. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=5&RS=TEST";
    + A, Y9 K" v! i
70. 
    ; C- L8 |& A) q& @( ~$ }
71. //删除好友
    ! [6 X! T- l+ r0 y# Y8 k/ y
72. $poststring[] = "VER=1.1&CMD=DelFromList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    4 z" Z  ]. X/ f8 z
73. 
    
74. //改变状态
    4 o8 E# T! {7 F! h6 j4 G
75. for($i=0;$i<=60;$i=$i+5)
    
76. {
    
77. $poststring[] = "VER=1.1&CMD=Change_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&ST=".$i;
    % I! s- u' l8 q' i! D) ?( ~
78. }
    
79. 
    ! J7 b! ~* ]1 _
80. //获得消息
    . z, w; j( f: V$ }
81. $poststring[] = "VER=1.1&CMD=GetMsgEx&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    
82. 
    1 c$ S( {! _% t' x/ F
83. //发送消息
    
84. $poststring[] = "VER=1.1&CMD=CLTMSG&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&MG=TEST";
    
85. 
    5 C! G, E* z4 Z
86. //登出
    7 z" G1 `! A" M/ i/ u: g& y
87. $poststring[] = "VER=1.1&CMD=Logout&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    
88. 
    ' ?7 D  Q9 M: Q1 w- r- W
89. $file = fopen("p.txt","w");
    ) i0 }* [3 T# f' w4 W
90. 
    
91. foreach($poststring as $k=>$v)
    , Y- H2 @2 Z: B, u8 i5 r
92. {
    
93. ss_timing_start();
    - X( D0 u. U& _" r, a* Q9 l% {5 F
94. $fp = fsockopen('tqq.tencent.com', '8000', $errno, $errstr, $timeout = 10);  
    
95. 
    ) R9 z! O( K. U$ s$ ^1 ~2 c0 \
96. if(!$fp){  
    7 L$ M  G, _" j) f& B$ ~
97. //error tell us  
    % ?9 b* Z$ |! C, m& Y/ P; n
98. $content = $k.chr(13).chr(10)."ERROR:$errstr ($errno)";  
    $ @8 C; K1 M2 \+ |  o4 |' ?
99.    
    
100. }else{  
     
101. 
     
102.   //send the server request  
     & P7 E6 p6 {% N4 N0 i! |, ^
103.   fputs($fp, "POST HTTP/1.1\r\n");  
     
104. //  fputs($fp, "Host: $host\r\n");  
     " x1 K" k  R$ F2 F
105. //  fputs($fp, "Content-type: application/x-www-form-urlencoded\r\n");  
     
106.   fputs($fp, "Content-length: ".strlen($v)."\r\n");  
     ' H1 o! W% s' G$ Q5 N
107.   fputs($fp, "Connection: close\r\n\r\n");  
     * p# q- c3 T& [) q% Z& A# w
108.   fputs($fp, $v . "\r\n\r\n");  
     8 t! d" D% p% J0 @" }
109. 
       h0 X  Z1 i4 i+ p
110.   //loop through the response from the server  
     0 H; L& }$ t+ k' V* K- P* ]8 S6 @
111.   $res = "";
     
112.   while(!feof($fp)) {  
     
113.   $res .= fgets($fp, 4096);  
     - ~( ~+ a5 |- L' R, z: J- E
114.   }  
     
115.   //close fp - we are done with it  
     
116.   fclose($fp);  
     2 _# M0 ^0 w" K. Z1 x/ h! D0 A0 h5 m
117. 
     ' x0 p% M+ M, _# J8 u
118.   $content = $v.chr(13).chr(10).$res;
     1 _1 S* |1 y1 h
119. }  
     
120. ss_timing_stop();  
     8 t3 |' A* B# w) T
121. $content .= chr(13).chr(10)."Time: ".ss_timing_current().chr(13).chr(10)."--------------------------------------".chr(13).chr(10);
     9 W' Q; O3 [, E0 N* \$ w
122. fputs($file,$content);
     
123. }
     $ l- j; L* l& o% G' r
124. fclose($file);
     - @* E$ u% ?6 B$ N
125. ?>
     , O  b6 D( P3 R8 l; A% P  Q
126. <?
     % s- O9 ]$ [+ s0 d: J
127. function ss_timing_start ($name = "default") {  
     
128. global $ss_timing_start_times;  
     
129. $ss_timing_start_times[$name] = explode(' ', microtime());  
     
130. }  
     - D0 q" c$ R' I2 @5 ]" c
131. function ss_timing_stop ($name = "default") {  
     
132. global $ss_timing_stop_times;  
     
133. $ss_timing_stop_times[$name] = explode(' ', microtime());  
     
134. }  
     + `3 w2 y# G$ J- X
135. function ss_timing_current ($name = "default") {  
     2 A4 ]2 Q0 a) C4 I( S
136. global $ss_timing_start_times, $ss_timing_stop_times;  
     0 n" J7 |5 j( H6 y; n8 }# u' ]" P7 _5 {
137. if (!isset($ss_timing_start_times[$name])) {  
     : Z; g- h' {1 m) ^
138. return 0;  
     , H3 v2 ~8 O& O( o+ R
139. }  
     
140. if (!isset($ss_timing_stop_times[$name])) {  
     
141. $stop_time = explode(' ', microtime());  
     ' G6 B& {' c: v- V# [/ h
142. }  
     1 a" n7 \$ H) D) |  A# y
143. else {  
     
144. $stop_time = $ss_timing_stop_times[$name];  
     + x$ G& d& \- w" A  a' y
145. }  
     1 U, [0 L: S3 w# u& v) L+ K
146. $current  =  $stop_time[1]-$ss_timing_start_times[$name][1];  
     3 U9 l2 H1 s2 @2 [
147. $current += $stop_time[0]-$ss_timing_start_times[$name][0];  
     , t2 n! k7 R. d5 H
148. return $current;  
     
149. }  
     
150. ?>

复制代码

. m( k% j! Q1 l8 y7 F: _４、研究成果：
+ F% `2 C: Y! A( N7 u
6 u: X5 @- ~5 W! d* a8 m+ V(1).登陆
　　说明：在你做任何其他操作以前，你必须登陆。只有在登陆以后，你的其他指令才有可能被正确执行(返回RES=0)，不然服务器会返回RES= 20，不过有个例外，就是logout。当你成功登陆以后，服务器就会根据你的IP*和参数中的UIN来验证身份。一台电脑可以同时登陆多个QQ，互不影响，就是因为有参数UIN。
　　*至于我能够确定服务器是通过IP来验证的，是因为服务器不可能通过我的请求获得其他信息了^_^

- T5 n* D8 [4 V' _: A1 {$ Y　　提交数据：VER=1.1&CMD=Login&SEQ=标记&UIN=QQ号&PS=QQ密码&M5=1&LC=9326B87B234E7235
　　说明：QQ密码是通过md5加密的字符串，在PHP中可以直接用md5()进行加密；
　　　　　M5这个参数的作用还不清楚，但最好为1。
　　　　　LC这个参数有点神秘，不能有丝毫改动，不然服务器就没有响应(没有响应就是返回NULL)。
/ @" L' x6 ^1 n3 E4 |' b
9 k. h. w8 X. u" Z$ i& i　　返回：VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=0&RS=0&HI=60&LI=300(成功)
　　　　　VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=0&RS=1&RA=密码错误(密码错误)
, A$ L  T) ^2 X/ @　　　　　VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=5(QQ号非法，如100)
- d; F  o# H! V% c" \4 B　　　　　NULL(UIN为字符、PS为空、LC错误)

(2).得到好友列表
% C2 c! [& |, _' O　　提交数据：VER=1.1&CMD=List&SEQ=标记&UIN=QQ号&TN=160&UN=0
. g0 C( K: f# }/ L& W　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响

　　返回：VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=0&FN=9(当TN=0或没有TN参数时，FN表示好友数)
0 a/ _) K/ a* C7 _! y　　　　　VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=0&FN= 1&SN=9&UN=3814526,...,(当TN存在且非0时，FN=1，SN表示好友数，UN为好友列表，用","分割)
; D, d/ k+ r/ @8 P. `7 q  y, @/ m　　　　　VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
% ?9 p  e5 I- S( f. i" n8 p　　　　　NULL(UIN、TN、UN为字符)

9 @. ]  O! Z2 b- ]: _(3).得到在线好友列表
9 b( ?2 `! x. H0 R2 M　　提交数据：VER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号&TN=50&UN=0
& R* r" @( z% _9 G! {　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响

　　返回：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的值用','分割，分别表示头像、状态、号码、昵称)
6 K* h' A9 H/ W! H　　　　　VER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
. \, _4 d8 u; `3 T* ]+ I　　　　　NULL(UIN、TN、UN为字符)
; K: b; ~" p7 O# o+ K　　说明：FC为QQ头像的的ID，如的头像ID为270，那么其头使用的图片为91.bmp,其算法为ID/3+1；
5 j- y) v* ~+ b5 h5 t$ x* `　　　　　ST为QQ用户的状态，10为上线，20为离线(或隐身)，30为忙碌；
$ j% W+ P3 i( V2 P  Y, B5 `
9 y8 m, m  K* ?; S　　特别说明：当参数TN=0或不存在时，服务器返回：
0 w1 l2 R% Z$ x/ V/ d6 dVER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号
+ a+ Z$ e- h) m' o; l4 p( q1 VHTTP/1.1 200 OK
Server: tencent imserver/1.0.0
Content-Type: text/plain; charset=UTF-8
7 ~, _  X/ [% G# ]Content-Length: 56

VER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FN=1
HTTP/1.1 200 OK
Server: tencent imserver/1.0.0
Content-Type: text/plain; charset=UTF-8
* e: H5 N1 |- i/ ^Content-Length: 77

VER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FC=&FN=1&SN=0&ST=&UN=&NK=
' I' s6 f3 q" b: a  t; M　　返回了２次，第一次的结果中，FN为在线好友数，第二次返回的数据基本没用。

(4).查看好友信息
　　提交数据：VER=1.1&CMD=GetInfo&SEQ=标记&UIN=QQ号&LV=查询类型&UN=被查询QQ号码
  O1 F7 Q4 N& l+ n　　说明：LV=0,1为精简查询，LV=2为普通查询，LV>=3为详细查询

. \# [( {  B9 q5 I　　返回：VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=0&LV=0&UN=106814&NK=Hackfan 好(精简查询)
　　　　　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=学生
3 _& M3 ]; C6 |+ G  `! [& |; N( V# r1 k&LV=2&PC=邮编&PH=电话&PR= The guy is updating to .NET Frameword......&PV=江苏&RN=胡吉阳&SC= 毕业院校&SX=0&UN=106814&NK=Hackfan  
% |  [9 t* g, C; z5 i" t好(普通查询)
　　　　　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  
' K' S! s9 z* d: `- Y, \updating to .NET Frameword......&PV=江苏&RN=胡吉阳&SC=毕业院校&SH=3&SX=0&UN=106814&NK=Hackfan 好(详细查询)
　　　　　VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
8 |. f0 z8 N+ e8 i　　　　　NULL(UIN、LV、UN为字符)
9 ]# a3 C* _- p4 _: M
　　说明：AD为联系地址
. \( E' m+ h% L. B7 u8 W　　　　　AG为年龄
2 f7 E1 x% ~6 k. ?) c% g- @　　　　　BT为血型
　　　　　CO为星座
4 A' |, G* C1 B7 }7 U0 p　　　　　CT为城市
　　　　　CV为未知*
　　　　　CY为国家
　　　　　EM为Email
$ ]' G( ?+ B# d  [2 I  y% q/ |% h　　　　　FC为头像
1 [: B( d0 I) Q" p/ P　　　　　HP为网站
　　　　　ID为未知
　　　　　JB为职业
& M% r) ]! Y5 I& Q　　　　　LV为查询代码(就是发送的LV)
# i- U" n0 T: b3 _% [; X/ l$ A) P$ @　　　　　MO为移动电话
　　　　　MT为未知
8 T) d3 ]4 M: [% p9 b　　　　　MV为未知
　　　　　PC为邮编
# J% C: m* u& b& ^: w# P( V( U7 Z$ G2 ^& z　　　　　PH为联系电话
　　　　　PR为简介
　　　　　PV为省
　　　　　RN为真实姓名
　　　　　SC为毕业院校
　　　　　SH为生肖
7 q# [- y* A* o　　　　　SX为性别
　　　　　UN为QQ号
　　　　　NK为昵称

　　　　　血型：0 => '',
　　　　　　　　1 => 'A型',
5 J- `* b. H" x1 `+ u/ }; o　　　　　　　　2 => 'B型',
; l# j( x5 R, L　　　　　　　　3 => 'O型',
( f9 s. o  f) T7 s- B( |　　　　　　　　4 => 'AB型',
　　　　　　　　5 => '其他'


　　　　　星座：0 => '',
　　　　　　　　1 => '水瓶座',
　　　　　　　　2 => '双鱼座',
4 i+ G  S) @! R2 _  u; _0 K　　　　　　　　3 => '牡羊座',
% b& f# F0 j) G* R; }　　　　　　　　4 => '金牛座',
4 P' B5 |% d! M* Y. G　　　　　　　　5 => '双子座',
　　　　　　　　6 => '巨蟹座',
: \8 V2 Z2 ]* _2 F　　　　　　　　7 => '狮子座',
+ r( n8 k% E" e! b) @) y　　　　　　　　8 => '座',
9 `. ~( u; J7 Q" I　　　　　　　　9 => '天秤座',
　　　　　　　　10 => '天蝎座',
　　　　　　　　11 => '射手座',
　　　　　　　　12 => '摩羯座'
0 j) W0 j4 c+ `9 g
　　　　　生肖：0 => '',
2 q5 ^* v0 }2 T8 y　　　　　　　　1 => '鼠',
　　　　　　　　2 => '牛',
( a9 r' {& ~/ }0 G# x# @9 ?( w　　　　　　　　3 => '虎',
( W7 m5 m% x  V$ F+ {4 w　　　　　　　　4 => '兔',
　　　　　　　　5 => '龙',
　　　　　　　　6 => '蛇',
　　　　　　　　7 => '马',
　　　　　　　　8 => '羊',
+ `9 M4 M: s! d" R　　　　　　　　9 => '猴',
　　　　　　　　10 => '鸡',
　　　　　　　　11 => '狗',
　　　　　　　　12 => '猪'

0 Y; c- r8 P7 @" d　　　　　性别：0 => '男',
　　　　　　　　1 => '女'

' }4 Q% B/ `' e/ U(5).增加好友
8 C/ ?) Z9 W  |4 N. F- |8 G　　提交数据：VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号
, `% g5 f' [5 n7 N6 \$ x9 ]' Q9 A
  n( p3 V. t* A, j/ E# \1 g　　返回：VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=0&UN=对方QQ号(允许被加为好友，此时他已经是你的好友)
　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=1&UN=对方QQ号(需要验证)
  n" d& b+ W& z# [' R　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=2&UN=对方QQ号(决绝被加为好友)
　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
1 x. f9 c( k' @+ _2 C+ K7 n　　　　　NULL(UIN、UN为字符)

(5).发送验证
$ |' r) v2 J6 D  y. Z/ ~　　说明：1、如果你加对方为好友，你需要发送验证
+ B! \; O4 s; [. V5 E; K　　　　　2、对方加你为好友，发送了验证，你要通过或者拒绝
　　　　　这2种情况需要发送验证消息
( ]/ n+ t* [' o3 S( v
　　提交数据：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(成功)
9 J0 k4 X3 {3 g' R: D8 z  P0 {" X　　　　　VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=3(*)
' ^! e9 _% \4 `1 W" l2 ]　　　　　VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
5 \& g/ p% k, E8 q4 p　　　　　NULL(UIN、UN、CD为字符，RS为非UTF-8字符)
9 y9 S: k- G7 z- O　　*如果服务器返回RES=3，那么这次对话的响应时间在20s。当发送验证请求的时候，必须连发2次(请求内容不必一样)，其中一条RES=3，对方收不到，一条RES=0，对方能够收到。当CD>=3时，RES=3，响应时间20s。
/ @$ m; s  j  C# ~
8 E# K$ k) x9 k# _1 o- f(6).删除好友
　　提交数据：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&UN=删除的QQ号
! U# D8 ^2 v1 l7 I5 m
　　返回：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=0&(成功)
0 a( @$ j8 _  u1 A8 s　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=3(响应时间30s，重复发送的后果)
　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、UN为字符)

5 q7 q, x4 L) v0 E(7).改变状态
　　提交数据：VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&ST=状态代码
　　说明：状态代码：10为上线，20为离线，30为忙碌，40为隐身，其他视为非法
! r+ [$ H# Y& M( D+ `) J
! U3 k, B+ B' l$ I( t' U! ~; ^+ p* I" F　　返回：VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=0&(成功)
　　　　　VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=3(失败，原因不明，响应时间20s，可能是过于频繁的改变状态引起的)
　　　　　VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
0 ?# L9 I! Y- y6 v3 q1 x  o　　　　　NULL(UIN为字符，ST非法)
! s$ x7 a% W: b$ r* b! _
　　特别说明：如果你改变好友，将会给所有好友发送一条系统信息，内容就是状态代码；如果隐身，发送的状态代码为20，表示离线。
1 l+ l$ }, f- _1 t" G/ n) m" \4 E　　　　　　　同理，当你的好友改变状态，你也会收到一条系统信息。

8 S( q/ x4 C% x6 v* [! s(9).获得消息
3 U) r* R, Q) K' X　　提交数据：VER=1.1&CMD=GetMsgEx&SEQ=标记&UIN=QQ号

" g- W$ r+ S. U8 P" U　　返回：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的值用","分割，分别表示消息类型、发送人号码、消息内容)
: D7 k9 A; m; ?% m7 w* r0 e# Z( A# |　　　　　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(没有正确登陆)
3 Z/ K" i+ r' |3 l; M　　　　　NULL(UIN为字符)
& E9 F3 d" w2 U+ N* x) L/ C$ N　　说明：关于MT：
　　　　　　　9为用户消息，99为系统消息，2为请求信息，3为通过验证，4为拒绝被加好友
　　　　　关于MG：
　　　　　　　当MT=9时，MG为用户发送的消息内容
　　　　　　　当MT=99时,
　　　　　　　　　MG=10(QQ_STATUS_ONLINE)表示对方上线
　　　　　　　　　MG=20(QQ_STATUS_OFFLINE)表示对方下线
　　　　　　　　　MG=30(QQ_STATUS_BUSY)表示对方进入忙碌状态
　　　　　　　当MT=2时，MG为对方请求你验证的信息
　　　　　　　当MT=3时，表示对方通过你的验证
+ ^1 m& r* A& j　　　　　　　当MT=4时，MG为对方拒绝你理由
' m- ^( V- v" W8 O  u; K/ Z
+ ?! y( A5 L6 Y(10).发送消息
* J3 ^. J# @) `$ c4 j% m9 G# [　　提交数据：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&UN=对方QQ号&MG=发送内容
7 J; y* q' h: S2 ^  }& y
　　返回：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=0&(成功发送，对方不一定能收到哦)
　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=3(发送过快)
9 [2 N+ C* O7 I0 c% K, l　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
6 e% |& ?( x# O, z1 w　　　　　NULL(UIN、UN为字符，MG含非UTF-8字符)
　　说明：1、当你发消息时，以下情形对方可能看不到(其实是收到了，QQ不提示)你发送的消息：
/ F. A+ E5 X2 J5 ]8 r( N0 |　　　　　　　你俩互为陌生人，且对方没有和你说过话
　　　　　　　你在他的陌生人列表里，并且他没有和你说过话(没有验证)
+ E: w* S/ G1 Q; u　　　　　2、当你过快发送消息时，系统会给你一个惩罚，RES=3，相应时间20s
8 _" T) [4 l0 p. Y2 x' Q　　　　　3、当我发送含有小写字母h的信息时，服务器有可能返回NULL

. O5 Y5 E1 q* Z! ^; W(11).登出
: l$ d( p1 I( D- j- o% \5 x1 S　　提交数据：VER=1.1&CMD=Logout&SEQ=标记&UIN=QQ号
6 v7 \2 T! K. p2 J
　　返回：VER=1.1&CMD=LOGOUT&SEQ=标记&UIN=QQ号&RES=0(成功，好像永远成功的，不管你是否登陆)
8 o0 Z; R, B' y4 m% d　　　　　NULL(UIN为字符)

( Y) t# s; l2 {( D" u" ?  a５、总结
( n- `8 B- |" J5 z7 f+ c7 o
, {* I5 P- F- i. x- R8 _( Q　　通过对照以上的接口说明，我开发出了能够实现基本QQ功能的PHP类，它整合了以上所有的接口，使用更方便，可以开发QQ机器人、群发广告程序等。免费获得类的代码请到
　　http://blog.hackfan.net/index.ph ... d=a_20050819_223558
) Z: S6 e2 f3 q# g: b$ x" V! d8 i3 [　　本文撰写时间仓促，难免有误，希望各位不吝赐教
2 v* T0 n* {. [% x
) U. Z: k7 h" y# O5 V. J& C% l7 J- V
4 M" W0 x$ `  }& A: |) ^4 oTrackback: http://tb.donews.net/TrackBack.aspx?PostId=520301