QQ的HTTP接口探究

天云上人

作者：Hackfan
# x! v9 J1 D$ C7 X* C- J, |& j日期：2005.8.21凌晨
/ y+ D* _2 M& z* k联系：QQ:106814 Email:hackfan@vip.sina.com
' b4 K7 l8 Q: v% B/ `1 D& d: X2 E# J
１、研究说明

　　Tencent在tqq.tencent.com的8000有一个使用HTTP的QQ接口，通过这个接口，可以进行一些基本的操作，如：登陆、登出、改变登陆状态(上线、忙碌、离线、隐身)、添加删除好友、查看好友信息、发送验证信息(接受被加为好友、申请加对方为好友、拒绝被加为好友)、收发用户消息、系统信息。
  V% b0 e' I- J
　　目前我研究的是1.1版本的HTTP QQ协议，研究是微程在的成果上进行的，不敢说有什么超越，只不过更为详细和准确。

２、接口说明：
& m& O0 A1 b$ t- {, |, s9 Y, n
　　接口位置：tqq.tencent.com:8000
　　通信协议：HTTP
) Q' W5 C6 e6 L8 H　　数据传输方法：POST
- }$ r$ S2 J  ?' v- |" S　　HTTP请求格式：

! {% d3 Q8 f3 o6 E# ~6 `- x8 u7 s/ XPOST HTTP/1.1
. ~: O& E* p3 V6 J( C+ tHost: tqq.tencent.com:8000
% U7 J8 u# N6 ~1 X4 i9 W9 l5 OContent-Type: text/plain; charset=UTF-8
% e9 c4 `; b  g' }& eContent-length: 长度
Connection: close
' @# F8 P2 \, P- z" x; _) }- d( V
  I$ b/ t8 h5 S数据
& B& m. N5 d9 O9 K9 W$ R6 p( S5 d
　　其中长度为 数据 的长度，数据的格式：
( x# c/ V, A  i; G, i* h! Q　　VER=1.1&CMD=命令&SEQ=标记&UIN=QQ号&....
3 y# J3 j  u" H/ T1 G+ z) T
* S0 I: r' w0 w( u  U　　以上４个参数是每个请求都必有的。其中，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还需要不同的参数，下面我就公布我的研究成果。
1 o9 w. z# L1 N0 M6 ]/ W% y* i  \
# |5 P6 B* Q$ r9 z* H３、研究方法：

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

1. <?
   
2. $uin = "QQ号";
   3 O- y( K4 d) F
3. $pwd = md5("QQ密码");
   - f9 ~$ Y9 N. B- p  M
4. 
   ; \2 I3 n4 y0 x; Z' a% C
5. //登陆测试
   # A% f  W8 k  a* ]% r) T
6. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=1&LC=9326B87B234E7235";
   
7. //注意：登陆测试不能同时进行，必须等到服务器认为QQ断开了，才能够测试，不然结果不可信
   6 f1 R" F* d5 D7 B; O8 l
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";
    4 V- r$ w9 P# C! L+ K9 o
11. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=2&LC=9326B87B234E7235";
    " _7 G% |# t% H( z6 {0 w$ L& j
12. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=3&LC=9326B87B234E7235";
    , ~, M. p/ T0 o" j: g% v' H% `# `6 j+ h6 U
13. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M6=1&LC=9326B87B234E7235";
    / \& g6 K( h2 K3 m- o7 Z0 g2 M
14. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M6=1&LC=1223423545756679";
    ' K* T7 Q) |. C
15. *******/
    9 D1 J+ h0 q( |7 N; a
16. 
    
17. 
    
18. //得到好友列表
    
19. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin;
    ; q5 }6 n- s+ X( m
20. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0";
    ; L: j& k. N1 _8 E
21. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160";
    
22. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=0";
    8 M, s3 U5 |: D' e/ V
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";
    : d( v8 m: c8 Y" G" s
25. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    7 V8 Z, V+ Q2 G5 s
26. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    : M5 W. W: i( l
27. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    
28. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    # ?2 W0 n7 P3 h! D( o% y- B
29. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    / D4 u% J, ]2 B2 I  d$ \: t$ i( t' N
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);
    
32. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    + [% y  q% i7 n% r2 F
33. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=106814";
    
34. 
    $ G' G. h" @4 `6 k  X
35. //得到在线列表
    
36. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin;
    ( q' e0 d0 e+ B) f& f* K
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";
    4 h7 v5 x0 q/ |! P4 d( A
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";
    ; a# e6 \. u" W6 P/ u! t( h
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";
    : [6 V$ g7 c8 r1 h1 f
44. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    # }$ E3 \9 S  F; q  i
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";
    % e$ i- g+ k- G! o( n
47. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    / a% q# i, t- a8 Q4 L! y1 p
48. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    $ u. c5 B4 d  b' c: O
49. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    
50. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=106814";
    
51. 
    ( X* D8 d) R6 H6 o  n, d
52. //查看好友信息
      M; P( u! q0 W% q" ?  I
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";
      [6 J# @* W5 X4 y; [2 u
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";
      G) t7 U: n% y: o- }5 m+ ]5 Z& _+ `
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";
    # b. K- O$ M7 }5 u% [
59. 
    2 {6 [8 T/ ], [
60. //增加好友
    
61. $poststring[] = "VER=1.1&CMD=AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    
62. 
    $ r9 Y! s9 }0 ]3 I+ a( _! I$ G
63. //发送验证
    
64. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=0&RS=TEST";
    ! U$ {/ v8 G4 o) u4 F
65. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=1&RS=TEST";
    " m- @2 C2 S; }* ^: o8 u" \
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";
    
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";
    
70. 
    5 Y1 D: j& N4 Z
71. //删除好友
    8 F0 Z( v; d) c$ u" R- Q: q- Q
72. $poststring[] = "VER=1.1&CMD=DelFromList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    5 d% n. b- z/ d8 ?7 G
73. 
    
74. //改变状态
    
75. for($i=0;$i<=60;$i=$i+5)
    , F* H' u' v# U) Q: h4 O% c
76. {
    
77. $poststring[] = "VER=1.1&CMD=Change_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&ST=".$i;
    
78. }
    
79. 
    & g% E$ D$ P0 d& F; P. S
80. //获得消息
    , v. C+ n3 T/ `
81. $poststring[] = "VER=1.1&CMD=GetMsgEx&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    
82. 
    
83. //发送消息
    
84. $poststring[] = "VER=1.1&CMD=CLTMSG&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&MG=TEST";
    
85. 
    
86. //登出
    & w) O0 z& R2 b5 G% X
87. $poststring[] = "VER=1.1&CMD=Logout&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    7 }5 ^4 f2 w% F2 s7 @, x. o8 d  H
88. 
    
89. $file = fopen("p.txt","w");
    
90. 
    2 N4 K' Q" ~/ E2 e9 Y
91. foreach($poststring as $k=>$v)
    
92. {
    3 ?9 Z2 b+ u8 `$ R5 ?
93. ss_timing_start();
    
94. $fp = fsockopen('tqq.tencent.com', '8000', $errno, $errstr, $timeout = 10);  
    
95. 
    
96. if(!$fp){  
    
97. //error tell us  
    ( C; t* c& Z" b- G
98. $content = $k.chr(13).chr(10)."ERROR:$errstr ($errno)";  
    
99.    
    8 b: q8 ^! r& V) e0 y- H. I. S
100. }else{  
     
101. 
     
102.   //send the server request  
     
103.   fputs($fp, "POST HTTP/1.1\r\n");  
     
104. //  fputs($fp, "Host: $host\r\n");  
     : M" d6 w/ h3 x) Q- c
105. //  fputs($fp, "Content-type: application/x-www-form-urlencoded\r\n");  
     9 x, V8 J$ N+ ]* ]
106.   fputs($fp, "Content-length: ".strlen($v)."\r\n");  
     3 c* d* p$ A7 r& o" o5 l
107.   fputs($fp, "Connection: close\r\n\r\n");  
     
108.   fputs($fp, $v . "\r\n\r\n");  
     4 j) j1 s8 }2 F9 ^! {) s* K
109. 
     % Z6 E- m. `2 h
110.   //loop through the response from the server  
     
111.   $res = "";
       N9 i  M8 O* T0 \; Z5 Z
112.   while(!feof($fp)) {  
     
113.   $res .= fgets($fp, 4096);  
     
114.   }  
     0 c7 f4 _; l2 W% w( F0 {
115.   //close fp - we are done with it  
     
116.   fclose($fp);  
     
117. 
     
118.   $content = $v.chr(13).chr(10).$res;
     ; _9 _& o; U& h) d) {
119. }  
     7 T" j& V; i- s
120. ss_timing_stop();  
     
121. $content .= chr(13).chr(10)."Time: ".ss_timing_current().chr(13).chr(10)."--------------------------------------".chr(13).chr(10);
     : Z/ w& I% F4 a# c4 O
122. fputs($file,$content);
     
123. }
     , V+ Q4 Q2 S5 ]3 ?) u; l1 \
124. fclose($file);
     % R( X) X0 o; G
125. ?>
     
126. <?
     8 ~" T, t& m( G
127. function ss_timing_start ($name = "default") {  
     
128. global $ss_timing_start_times;  
     5 F: T1 A% @( r9 l
129. $ss_timing_start_times[$name] = explode(' ', microtime());  
     3 {3 M* M3 f7 ]0 Y
130. }  
     
131. function ss_timing_stop ($name = "default") {  
     ' q5 J0 N( p9 `! T9 \
132. global $ss_timing_stop_times;  
     , q$ W1 S8 v# H
133. $ss_timing_stop_times[$name] = explode(' ', microtime());  
     
134. }  
     
135. function ss_timing_current ($name = "default") {  
     1 V; J; V6 ?* ]% M4 E  d9 _% e
136. global $ss_timing_start_times, $ss_timing_stop_times;  
     - b  E" Z& H& N* C9 h
137. if (!isset($ss_timing_start_times[$name])) {  
     
138. return 0;  
     
139. }  
     
140. if (!isset($ss_timing_stop_times[$name])) {  
     & _/ k6 E3 @3 \8 u: S  s7 a  i: G
141. $stop_time = explode(' ', microtime());  
     + S, U, U8 D  \5 u
142. }  
     1 g% m! R2 v* c( H
143. else {  
     9 `, S; k# i% v( n4 r0 l
144. $stop_time = $ss_timing_stop_times[$name];  
     8 e1 M. i; Y# h! Z( a. M' E
145. }  
     
146. $current  =  $stop_time[1]-$ss_timing_start_times[$name][1];  
     / X, M/ v. `% Q+ a  T8 y
147. $current += $stop_time[0]-$ss_timing_start_times[$name][0];  
     9 O: V* k  X5 n6 s; ^# L; V9 u
148. return $current;  
     . K: E5 T& {- c% X
149. }  
     + ?' L# c. a* g1 l0 k: E0 `- {
150. ?>

复制代码

４、研究成果：

. p) d! v& M9 i% z: D; o(1).登陆
0 W/ i5 B2 d- U! h9 t　　说明：在你做任何其他操作以前，你必须登陆。只有在登陆以后，你的其他指令才有可能被正确执行(返回RES=0)，不然服务器会返回RES= 20，不过有个例外，就是logout。当你成功登陆以后，服务器就会根据你的IP*和参数中的UIN来验证身份。一台电脑可以同时登陆多个QQ，互不影响，就是因为有参数UIN。
　　*至于我能够确定服务器是通过IP来验证的，是因为服务器不可能通过我的请求获得其他信息了^_^

8 S, W: O! `: R7 ~　　提交数据：VER=1.1&CMD=Login&SEQ=标记&UIN=QQ号&PS=QQ密码&M5=1&LC=9326B87B234E7235
　　说明：QQ密码是通过md5加密的字符串，在PHP中可以直接用md5()进行加密；
　　　　　M5这个参数的作用还不清楚，但最好为1。
　　　　　LC这个参数有点神秘，不能有丝毫改动，不然服务器就没有响应(没有响应就是返回NULL)。
; t7 l5 ^& q% q! H; a! k
　　返回：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=密码错误(密码错误)
/ I% s+ F+ |$ A4 e* [　　　　　VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=5(QQ号非法，如100)
* K0 b# L4 c, ?, q7 W) `8 G, S% k　　　　　NULL(UIN为字符、PS为空、LC错误)
. H9 K1 I9 Q0 h4 a: }
8 K. o2 ^5 E( l$ n- _; Q(2).得到好友列表
- O# _, `) m+ k; }　　提交数据：VER=1.1&CMD=List&SEQ=标记&UIN=QQ号&TN=160&UN=0
6 Y( [3 ~: j& x  Q　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响

　　返回：VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=0&FN=9(当TN=0或没有TN参数时，FN表示好友数)
1 a, O6 B- S: }  C; J' b% O　　　　　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(没有正确登陆)
- j& j4 @2 O" t$ J9 ?* q　　　　　NULL(UIN、TN、UN为字符)

(3).得到在线好友列表
; _" C& o+ w# ?! }+ j1 H　　提交数据：VER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号&TN=50&UN=0
- @' ]5 q! e( X0 f　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响
1 c! |6 N0 i: E
　　返回：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(没有正确登陆)
, I, M" T' X4 v( a2 }　　　　　NULL(UIN、TN、UN为字符)
8 C( Y3 U8 ]$ i- |) B8 n9 [　　说明：FC为QQ头像的的ID，如的头像ID为270，那么其头使用的图片为91.bmp,其算法为ID/3+1；
　　　　　ST为QQ用户的状态，10为上线，20为离线(或隐身)，30为忙碌；

　　特别说明：当参数TN=0或不存在时，服务器返回：
2 g$ w8 k. r2 H* m$ hVER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号
. d/ o' D7 }' P; L) eHTTP/1.1 200 OK
Server: tencent imserver/1.0.0
Content-Type: text/plain; charset=UTF-8
; b. _+ t; g- Z7 rContent-Length: 56

  C( k6 `* b( V! E8 oVER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FN=1
HTTP/1.1 200 OK
3 m2 B5 H: l0 |2 z" k; LServer: tencent imserver/1.0.0
Content-Type: text/plain; charset=UTF-8
9 E) E5 ?3 ~. j+ y; [Content-Length: 77

VER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FC=&FN=1&SN=0&ST=&UN=&NK=
　　返回了２次，第一次的结果中，FN为在线好友数，第二次返回的数据基本没用。
# Z0 f! E+ z! N. z! f
; i- P: s/ B1 i' n( G4 n& [+ Y! C(4).查看好友信息
9 _' R: x! Y* T8 g) ?　　提交数据：VER=1.1&CMD=GetInfo&SEQ=标记&UIN=QQ号&LV=查询类型&UN=被查询QQ号码
5 H; q; @6 m% B0 r! ^8 O9 ^+ \# R  Y　　说明：LV=0,1为精简查询，LV=2为普通查询，LV>=3为详细查询
( W( |, o! M! j6 x
　　返回：VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=0&LV=0&UN=106814&NK=Hackfan 好(精简查询)
* y, O+ P6 H% O　　　　　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=学生
, r. h! p5 I4 a&LV=2&PC=邮编&PH=电话&PR= The guy is updating to .NET Frameword......&PV=江苏&RN=胡吉阳&SC= 毕业院校&SX=0&UN=106814&NK=Hackfan  
; L5 e, ?* j0 f- h( O- `4 d好(普通查询)
( R: K7 Z' G7 ^, C. p4 B2 P　　　　　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  
* r0 `) f( g3 n4 J$ N0 A1 s2 B0 G! Hupdating to .NET Frameword......&PV=江苏&RN=胡吉阳&SC=毕业院校&SH=3&SX=0&UN=106814&NK=Hackfan 好(详细查询)
　　　　　VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、LV、UN为字符)
7 V# A6 y' N6 ]9 ^
* Y1 i$ R) N9 V4 r　　说明：AD为联系地址
# S6 F, v3 n* j# x; E" n& c　　　　　AG为年龄
　　　　　BT为血型
  Z+ o5 k8 c6 X. I( g　　　　　CO为星座
2 c0 z- w3 A4 J　　　　　CT为城市
, i& ~3 k7 q, R- @* ?' M" `　　　　　CV为未知*
　　　　　CY为国家
　　　　　EM为Email
3 v4 R  o, |/ W+ ^% i' T* }8 v! Z4 L　　　　　FC为头像
1 G9 W; h3 D7 b$ z　　　　　HP为网站
　　　　　ID为未知
　　　　　JB为职业
　　　　　LV为查询代码(就是发送的LV)
　　　　　MO为移动电话
　　　　　MT为未知
# z" F. ]! D  {  ]+ q) a　　　　　MV为未知
+ V7 r6 ^/ C* M. v, O　　　　　PC为邮编
: g! F! ~( y2 m5 O- E, N1 ?　　　　　PH为联系电话
' J( }8 L% w7 B7 J　　　　　PR为简介
; D! ^) c6 `% v# b: l# E4 X5 a5 Y　　　　　PV为省
& z& C! ?1 k- h, ~& P　　　　　RN为真实姓名
1 V/ D+ q6 `( o. j3 X# P　　　　　SC为毕业院校
　　　　　SH为生肖
　　　　　SX为性别
- [& {) p+ u# }　　　　　UN为QQ号
　　　　　NK为昵称

% p2 ?1 b! w% w8 k  T! X　　　　　血型：0 => '',
. A5 E  u* L7 I; y* c5 t9 L' h　　　　　　　　1 => 'A型',
, U) o) E7 f, c* q( }8 [　　　　　　　　2 => 'B型',
( J1 ?# P' }( s) x　　　　　　　　3 => 'O型',
　　　　　　　　4 => 'AB型',
$ b8 g$ n# M$ j. f- ~6 {, p/ u　　　　　　　　5 => '其他'


　　　　　星座：0 => '',
7 I5 T/ Z- [/ M/ l% K　　　　　　　　1 => '水瓶座',
　　　　　　　　2 => '双鱼座',
3 m( Q/ a: }0 O, f. n( x- I　　　　　　　　3 => '牡羊座',
　　　　　　　　4 => '金牛座',
　　　　　　　　5 => '双子座',
' O$ ~2 x: N( n0 Y! K　　　　　　　　6 => '巨蟹座',
) X* Y1 K( h  h& [, G　　　　　　　　7 => '狮子座',
　　　　　　　　8 => '座',
8 K8 K; O# s5 [1 q; N3 t　　　　　　　　9 => '天秤座',
　　　　　　　　10 => '天蝎座',
- m) u0 l' ]2 v5 _- e4 l' G　　　　　　　　11 => '射手座',
　　　　　　　　12 => '摩羯座'

# z' i! a, u# w" ~5 C　　　　　生肖：0 => '',
　　　　　　　　1 => '鼠',
　　　　　　　　2 => '牛',
　　　　　　　　3 => '虎',
　　　　　　　　4 => '兔',
7 Q. L- B' i: N6 y( {　　　　　　　　5 => '龙',
　　　　　　　　6 => '蛇',
　　　　　　　　7 => '马',
　　　　　　　　8 => '羊',
　　　　　　　　9 => '猴',
2 Z: a1 ^  o  r8 y; R　　　　　　　　10 => '鸡',
- C& {7 V. g) g- B5 e  [7 ?　　　　　　　　11 => '狗',
8 Q! R( a$ _4 d. _! @: R　　　　　　　　12 => '猪'
2 A) [, I. ~0 t+ s& _6 z5 @: ^
　　　　　性别：0 => '男',
　　　　　　　　1 => '女'
  k. f4 d1 m$ y8 ^
(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号(允许被加为好友，此时他已经是你的好友)
5 ^5 Y2 U3 c8 t! A2 c　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=1&UN=对方QQ号(需要验证)
$ m  _& V$ P  F5 M: \6 n+ E　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=2&UN=对方QQ号(决绝被加为好友)
- k$ q0 a$ t3 N1 j) h) P　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、UN为字符)

(5).发送验证
　　说明：1、如果你加对方为好友，你需要发送验证
　　　　　2、对方加你为好友，发送了验证，你要通过或者拒绝
　　　　　这2种情况需要发送验证消息
0 \; V7 x! R9 k2 m# F
6 O! G) i) L3 U! J2 Z. F1 c　　提交数据：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号&CD=验证类型&RS=理由
. o4 B5 g4 L5 i3 p9 K3 e5 V　　说明：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(*)
　　　　　VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、UN、CD为字符，RS为非UTF-8字符)
  ~# ^9 I6 K# }　　*如果服务器返回RES=3，那么这次对话的响应时间在20s。当发送验证请求的时候，必须连发2次(请求内容不必一样)，其中一条RES=3，对方收不到，一条RES=0，对方能够收到。当CD>=3时，RES=3，响应时间20s。
2 i" A1 b- i. y+ _8 z+ Y
(6).删除好友
) I3 A: d4 U- V, ]0 Y6 J　　提交数据：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&UN=删除的QQ号
1 I  _9 T0 A" U) d! c+ X" U* I7 T
　　返回：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=0&(成功)
　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=3(响应时间30s，重复发送的后果)
* n' A! `: F6 x; Z  k, w　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
# r" w& b; f; T( z6 ~　　　　　NULL(UIN、UN为字符)

(7).改变状态
　　提交数据：VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&ST=状态代码
　　说明：状态代码：10为上线，20为离线，30为忙碌，40为隐身，其他视为非法
7 t; |' C1 B4 ]: p# c, G. g+ T
# }0 i. k7 J7 m: q1 r　　返回：VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=0&(成功)
　　　　　VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=3(失败，原因不明，响应时间20s，可能是过于频繁的改变状态引起的)
5 a8 R. [, r9 k　　　　　VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN为字符，ST非法)
0 C9 e( I4 {  |7 [& `" T* y7 ]
: ?) S% ]) @2 j- C; V　　特别说明：如果你改变好友，将会给所有好友发送一条系统信息，内容就是状态代码；如果隐身，发送的状态代码为20，表示离线。
* F% O3 ~6 t$ `4 l# _　　　　　　　同理，当你的好友改变状态，你也会收到一条系统信息。
0 J% I" e. r+ T; r/ i
(9).获得消息
　　提交数据：VER=1.1&CMD=GetMsgEx&SEQ=标记&UIN=QQ号
3 {. X- D; H% R" _
9 [' e8 J/ M2 A/ h, e　　返回：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的值用","分割，分别表示消息类型、发送人号码、消息内容)
8 J+ x% A/ P+ K0 l1 }; [# h　　　　　VER=1.1&CMD=GETMSGEX&SEQ=标记&UIN=QQ号&RES=0&MN=0&MT=&UN=&MG=(表示没有信息)
. k0 C% O/ N8 H* K4 A　　　　　VER=1.1&CMD=GETMSGEX&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
7 t' E, F  _8 S6 A3 _0 y! p' R( L　　　　　NULL(UIN为字符)
　　说明：关于MT：
6 H4 I, J9 I3 J2 v9 Z　　　　　　　9为用户消息，99为系统消息，2为请求信息，3为通过验证，4为拒绝被加好友
　　　　　关于MG：
　　　　　　　当MT=9时，MG为用户发送的消息内容
8 r( ~7 x/ M$ R/ L1 s1 Q　　　　　　　当MT=99时,
1 }0 F- R: S) o% Y　　　　　　　　　MG=10(QQ_STATUS_ONLINE)表示对方上线
  t" r8 W7 P5 d- o: s7 j, S7 I　　　　　　　　　MG=20(QQ_STATUS_OFFLINE)表示对方下线
　　　　　　　　　MG=30(QQ_STATUS_BUSY)表示对方进入忙碌状态
) Y. ^. E: l9 P1 a# w! Z　　　　　　　当MT=2时，MG为对方请求你验证的信息
, K9 U2 M9 v) @* A　　　　　　　当MT=3时，表示对方通过你的验证
　　　　　　　当MT=4时，MG为对方拒绝你理由

3 g4 ^# P; C8 |/ S1 J2 C(10).发送消息
　　提交数据：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&UN=对方QQ号&MG=发送内容

) o; e8 g/ a- |　　返回：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=0&(成功发送，对方不一定能收到哦)
　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=3(发送过快)
　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、UN为字符，MG含非UTF-8字符)
　　说明：1、当你发消息时，以下情形对方可能看不到(其实是收到了，QQ不提示)你发送的消息：
　　　　　　　你俩互为陌生人，且对方没有和你说过话
( L; I2 Y: A# u* `$ O# {+ o　　　　　　　你在他的陌生人列表里，并且他没有和你说过话(没有验证)
8 q* `$ P: B' s# t7 ?" z　　　　　2、当你过快发送消息时，系统会给你一个惩罚，RES=3，相应时间20s
( D) B; l" r+ i9 k) ?" [& U: X! m6 o　　　　　3、当我发送含有小写字母h的信息时，服务器有可能返回NULL

1 L! F" a) j: B(11).登出
　　提交数据：VER=1.1&CMD=Logout&SEQ=标记&UIN=QQ号

. v) w% y1 L* X- U! k　　返回：VER=1.1&CMD=LOGOUT&SEQ=标记&UIN=QQ号&RES=0(成功，好像永远成功的，不管你是否登陆)
　　　　　NULL(UIN为字符)
( K, D+ Y/ x, {% F7 s7 T4 S
５、总结
$ D3 f' _! y7 r' U& G0 E) @
& E( X, X6 G, ]' W　　通过对照以上的接口说明，我开发出了能够实现基本QQ功能的PHP类，它整合了以上所有的接口，使用更方便，可以开发QQ机器人、群发广告程序等。免费获得类的代码请到
　　http://blog.hackfan.net/index.ph ... d=a_20050819_223558
　　本文撰写时间仓促，难免有误，希望各位不吝赐教


- l0 D$ f- v8 D  ~1 M: H" _. NTrackback: http://tb.donews.net/TrackBack.aspx?PostId=520301