QQ的HTTP接口探究

天云上人

作者：Hackfan
% [8 o, r* V" q$ ~3 ~日期：2005.8.21凌晨
5 P& Z) \  l; j, ?7 o' X联系：QQ:106814 Email:hackfan@vip.sina.com
2 J1 U' d. X& o
１、研究说明

4 E" a# |8 c# p5 F. f　　Tencent在tqq.tencent.com的8000有一个使用HTTP的QQ接口，通过这个接口，可以进行一些基本的操作，如：登陆、登出、改变登陆状态(上线、忙碌、离线、隐身)、添加删除好友、查看好友信息、发送验证信息(接受被加为好友、申请加对方为好友、拒绝被加为好友)、收发用户消息、系统信息。

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

２、接口说明：

+ ], l1 G6 _9 D　　接口位置：tqq.tencent.com:8000
1 t' B9 G7 ~/ b0 R+ h" v　　通信协议：HTTP
　　数据传输方法：POST
　　HTTP请求格式：

/ a* F  o+ s+ xPOST HTTP/1.1
$ j$ B7 }6 H7 N* ?0 v/ o  aHost: tqq.tencent.com:8000
Content-Type: text/plain; charset=UTF-8
Content-length: 长度
$ Z: F, C7 w  u7 _* K) nConnection: close

数据
! `+ _( Q" G8 W* z1 g. b: x
  N  M, W  N6 A# q! Q/ m. L6 U　　其中长度为 数据 的长度，数据的格式：
　　VER=1.1&CMD=命令&SEQ=标记&UIN=QQ号&....

& ]3 F8 u( O% ?: p4 G  P- p　　以上４个参数是每个请求都必有的。其中，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还需要不同的参数，下面我就公布我的研究成果。
: P' H$ ~2 U# E, |6 A
３、研究方法：

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

1. <?
   
2. $uin = "QQ号";
   # _; U) r" B  Q- {8 ^9 _
3. $pwd = md5("QQ密码");
   - [. V/ T5 j7 |+ z/ T
4. 
   
5. //登陆测试
   1 h) @- o. ~: v9 O/ ~; b( i: y1 _
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";
   1 n) n, A% e9 d! G2 M. a7 C) ^
10. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=1&LC=9326B87B234E7235";
    % \& @; `/ l* U  U, N7 W
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";
    ! {: y4 p0 U  `' e# I
13. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M6=1&LC=9326B87B234E7235";
    # C" V/ f9 P: ]- O, v
14. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M6=1&LC=1223423545756679";
    / v; `  @9 n# M$ `* d: A" W, j
15. *******/
    & f  O( j, o! _5 L& F' s( q+ P
16. 
      t5 p. j1 l) I4 x
17. 
    
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";
    
22. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=0";
    6 ]' S* c% [1 ?6 w/ I6 I
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";
    0 c$ x3 j. Z% C6 t
25. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    ) S* L, Z2 `  X& }9 }8 w% e
26. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    5 s! t  B1 ]0 d2 O1 _& w: \
27. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    " v% B( g; e) [' a, @/ Q
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);
    3 t0 D) v! e  |7 L8 b! p9 V1 ]7 L
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);
    ; z9 e4 E5 K5 ~/ s9 F0 T
33. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=106814";
    # b; m! A0 s6 i) w. R& F
34. 
    
35. //得到在线列表
    
36. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin;
    1 c3 v) |& ~- P7 l; X% v7 W& j0 H
37. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0";
    6 i1 \5 h; v8 T! D3 l8 c$ ]
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";
    
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";
      ?5 {/ O) T. Z" `# [( a7 g
44. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    ; Y0 Y9 b  M$ B: j3 w3 _
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";
      w% p5 @1 o! E% p! E2 ^- ^
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);
    - F* B- C8 k' u8 ~2 j+ c
49. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    + A3 U$ o" Z( I7 k3 g3 ~
50. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=106814";
    ) h& ^' d" X# @/ n9 I) G6 s
51. 
    ' m  V7 k# X' U; j- X$ ^
52. //查看好友信息
    6 L; ^( M3 \, M3 ]
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";
    0 Y2 H  o; [& }$ O
55. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=2&UN=106814";
    ; {# F' Q9 L/ Z, X
56. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=3&UN=106814";
    / g2 b6 d% a$ k" V; V$ T
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";
    * b9 M$ j& `* o9 z+ T" q0 [
59. 
    
60. //增加好友
    
61. $poststring[] = "VER=1.1&CMD=AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    6 i, K' b6 M3 _- r
62. 
    9 c  e" R, r8 K  n% N
63. //发送验证
    6 j; Q. X6 m4 H: M* p. D
64. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=0&RS=TEST";
    
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";
    + r: c; C7 R% c& k
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";
    0 y, \) g9 a" ~- f  L" }
69. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=5&RS=TEST";
    
70. 
    - _5 n/ h- s9 z) x9 d+ X# O; N( h6 z
71. //删除好友
    
72. $poststring[] = "VER=1.1&CMD=DelFromList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    0 y* i! k, X; v7 ?
73. 
    , Z. `1 O; N6 u% r0 m/ `. k# p
74. //改变状态
    8 V. o) x# h5 D3 n4 [) A
75. for($i=0;$i<=60;$i=$i+5)
    2 f" J& f; p8 E
76. {
    
77. $poststring[] = "VER=1.1&CMD=Change_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&ST=".$i;
    - {9 }8 P& N5 a# I4 h# u, E- A
78. }
    $ y. g& |0 {; k  h% P; C
79. 
    
80. //获得消息
    
81. $poststring[] = "VER=1.1&CMD=GetMsgEx&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    
82. 
    - }  a$ J0 s7 V0 Z! d" d: I  p- w
83. //发送消息
    
84. $poststring[] = "VER=1.1&CMD=CLTMSG&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&MG=TEST";
    ' o  p  ^4 m. g+ b& z9 A
85. 
    . n$ g0 H5 B3 B+ s8 {( e7 V
86. //登出
    
87. $poststring[] = "VER=1.1&CMD=Logout&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    % \" z& `9 m- @+ r$ c
88. 
      n, Z/ u/ e' G; u9 ?
89. $file = fopen("p.txt","w");
    
90. 
    
91. foreach($poststring as $k=>$v)
    
92. {
    . @6 W9 o5 l& A* h. J0 y
93. ss_timing_start();
    
94. $fp = fsockopen('tqq.tencent.com', '8000', $errno, $errstr, $timeout = 10);  
    
95. 
    
96. if(!$fp){  
    
97. //error tell us  
    
98. $content = $k.chr(13).chr(10)."ERROR:$errstr ($errno)";  
    & r2 k  ^. H1 Z" \! ^  w
99.    
    
100. }else{  
     
101. 
     
102.   //send the server request  
     3 Y7 [' X6 q. Y+ }& f  R
103.   fputs($fp, "POST HTTP/1.1\r\n");  
     ' y5 J: c/ v  H" J* G, R" v
104. //  fputs($fp, "Host: $host\r\n");  
     : R, `2 K4 Z& u
105. //  fputs($fp, "Content-type: application/x-www-form-urlencoded\r\n");  
     & }: Z- X' d% |0 C
106.   fputs($fp, "Content-length: ".strlen($v)."\r\n");  
     
107.   fputs($fp, "Connection: close\r\n\r\n");  
     
108.   fputs($fp, $v . "\r\n\r\n");  
     % [9 H, G' `/ R: N' @, I3 t# @
109. 
     
110.   //loop through the response from the server  
     
111.   $res = "";
     6 f6 r4 C5 ?2 u4 h
112.   while(!feof($fp)) {  
     
113.   $res .= fgets($fp, 4096);  
     
114.   }  
     + I( a  d: I* h% l, Q
115.   //close fp - we are done with it  
     7 ~" ]5 }( K/ p" i, G( c. Q$ _' U
116.   fclose($fp);  
     : p+ r- i5 H( _1 z( u% R. I
117. 
     
118.   $content = $v.chr(13).chr(10).$res;
     
119. }  
     : v; X6 i) g. N* _+ Y8 J
120. ss_timing_stop();  
     
121. $content .= chr(13).chr(10)."Time: ".ss_timing_current().chr(13).chr(10)."--------------------------------------".chr(13).chr(10);
     
122. fputs($file,$content);
     
123. }
     
124. fclose($file);
     " b0 Z* h" @  ]. N; k' @" i4 D
125. ?>
     
126. <?
     
127. function ss_timing_start ($name = "default") {  
     
128. global $ss_timing_start_times;  
     ( R6 k# w: i0 j- |  l+ ]6 n
129. $ss_timing_start_times[$name] = explode(' ', microtime());  
     
130. }  
     
131. function ss_timing_stop ($name = "default") {  
     & V- s% o  Y2 ]! R7 k! C& e
132. global $ss_timing_stop_times;  
     " |7 |( V$ Y4 F, u$ \+ o7 h1 I4 H
133. $ss_timing_stop_times[$name] = explode(' ', microtime());  
     : W' C: `6 M& j" m3 `; {. p
134. }  
     $ O$ b2 D' `  p7 s' I
135. function ss_timing_current ($name = "default") {  
     ( y. q9 m# O) c' n  |# h
136. global $ss_timing_start_times, $ss_timing_stop_times;  
     $ z% @4 e6 W/ O0 I+ E7 E2 W) W
137. if (!isset($ss_timing_start_times[$name])) {  
     ; Q4 U# `, g: s: B2 d! i  c
138. return 0;  
     
139. }  
     
140. if (!isset($ss_timing_stop_times[$name])) {  
       p  h* g: S0 ?! C  Y8 e. }( C/ a
141. $stop_time = explode(' ', microtime());  
     . S/ g6 w; [- G% y' O5 w5 r
142. }  
     
143. else {  
     1 }; T* p5 i' ^; Z% m7 t
144. $stop_time = $ss_timing_stop_times[$name];  
     / x* d' Q) ]9 T7 H- c  X; E
145. }  
     
146. $current  =  $stop_time[1]-$ss_timing_start_times[$name][1];  
     
147. $current += $stop_time[0]-$ss_timing_start_times[$name][0];  
     ) Z0 Q' V) i5 s7 J- e
148. return $current;  
     
149. }  
     
150. ?>

复制代码

４、研究成果：
/ @% H5 s9 ~2 E8 L3 ?
(1).登陆
　　说明：在你做任何其他操作以前，你必须登陆。只有在登陆以后，你的其他指令才有可能被正确执行(返回RES=0)，不然服务器会返回RES= 20，不过有个例外，就是logout。当你成功登陆以后，服务器就会根据你的IP*和参数中的UIN来验证身份。一台电脑可以同时登陆多个QQ，互不影响，就是因为有参数UIN。
　　*至于我能够确定服务器是通过IP来验证的，是因为服务器不可能通过我的请求获得其他信息了^_^
$ b* K7 {, O& l+ r$ M& n
　　提交数据：VER=1.1&CMD=Login&SEQ=标记&UIN=QQ号&PS=QQ密码&M5=1&LC=9326B87B234E7235
　　说明：QQ密码是通过md5加密的字符串，在PHP中可以直接用md5()进行加密；
+ x7 f' D- U) C　　　　　M5这个参数的作用还不清楚，但最好为1。
　　　　　LC这个参数有点神秘，不能有丝毫改动，不然服务器就没有响应(没有响应就是返回NULL)。

5 t9 @' m' A3 R5 `* {, A+ k- `　　返回：VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=0&RS=0&HI=60&LI=300(成功)
- h/ `3 H/ Q3 S. t$ L) E- _7 V　　　　　VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=0&RS=1&RA=密码错误(密码错误)
2 z) q" M& y+ O! [( ?: X" d　　　　　VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=5(QQ号非法，如100)
　　　　　NULL(UIN为字符、PS为空、LC错误)

, j3 B" R' d# D( p1 E(2).得到好友列表
6 J1 I7 ~) E# N1 y3 d: r- m　　提交数据：VER=1.1&CMD=List&SEQ=标记&UIN=QQ号&TN=160&UN=0
( ~$ Y5 P: l$ H3 E$ i/ \　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响
- \: E+ w7 V5 L% q
+ U4 g( B1 B3 m3 f- W+ P　　返回：VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=0&FN=9(当TN=0或没有TN参数时，FN表示好友数)
# Y) G. }6 W. ?- j　　　　　VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=0&FN= 1&SN=9&UN=3814526,...,(当TN存在且非0时，FN=1，SN表示好友数，UN为好友列表，用","分割)
) x) I1 h; p2 ~! l　　　　　VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、TN、UN为字符)
8 s- w) n0 N+ w0 O7 x6 L
5 ~4 B4 i6 l. r. w: r(3).得到在线好友列表
; ?2 s1 @0 D- @/ z% v6 \9 n　　提交数据：VER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号&TN=50&UN=0
; E& ~2 u$ ?5 U　　说明：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的值用','分割，分别表示头像、状态、号码、昵称)
9 I2 V1 g3 z! `- Y+ k  `0 V　　　　　VER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、TN、UN为字符)
0 v8 Y; A; j  Y  F  A　　说明：FC为QQ头像的的ID，如的头像ID为270，那么其头使用的图片为91.bmp,其算法为ID/3+1；
8 i# x2 [" D$ j5 p6 s# q4 t& z　　　　　ST为QQ用户的状态，10为上线，20为离线(或隐身)，30为忙碌；

　　特别说明：当参数TN=0或不存在时，服务器返回：
! {( K: a3 Y9 D0 }6 ^" E2 v8 l: hVER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号
2 t, h4 r2 H# EHTTP/1.1 200 OK
% w: c/ O9 J. f. a2 lServer: tencent imserver/1.0.0
8 W2 X  Y" ^( \2 O0 TContent-Type: text/plain; charset=UTF-8
Content-Length: 56

! X1 ?1 e' Q5 A; ?: l- eVER=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
Content-Length: 77

  m1 D* F8 ^( E/ ~- [1 vVER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FC=&FN=1&SN=0&ST=&UN=&NK=
6 c7 K" n# Q" w% S7 Z- n) L2 B$ o' w* t　　返回了２次，第一次的结果中，FN为在线好友数，第二次返回的数据基本没用。

6 D9 V" B7 y. k(4).查看好友信息
0 S7 l8 h/ o- f　　提交数据：VER=1.1&CMD=GetInfo&SEQ=标记&UIN=QQ号&LV=查询类型&UN=被查询QQ号码
　　说明：LV=0,1为精简查询，LV=2为普通查询，LV>=3为详细查询

　　返回：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=学生
&LV=2&PC=邮编&PH=电话&PR= The guy is updating to .NET Frameword......&PV=江苏&RN=胡吉阳&SC= 毕业院校&SX=0&UN=106814&NK=Hackfan  
* }1 T/ ^. Q, ]5 X/ Y5 ?好(普通查询)
　　　　　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 好(详细查询)
2 a) s% |8 B. s, d& C2 P4 O　　　　　VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、LV、UN为字符)
3 g# n; W( x9 \; K
+ a& h/ H, i% a9 N- t1 v, c　　说明：AD为联系地址
　　　　　AG为年龄
- ]- X, H* O& s7 `5 _* }　　　　　BT为血型
　　　　　CO为星座
8 D8 B; D5 `  C! U$ U　　　　　CT为城市
　　　　　CV为未知*
. J' M. V8 U' O　　　　　CY为国家
　　　　　EM为Email
　　　　　FC为头像
　　　　　HP为网站
0 ~* a* R9 e. I: c" j  {( e　　　　　ID为未知
　　　　　JB为职业
; c8 `* ?: ?' H1 g' L　　　　　LV为查询代码(就是发送的LV)
　　　　　MO为移动电话
　　　　　MT为未知
　　　　　MV为未知
　　　　　PC为邮编
# b! q1 |- ^: _) Z2 _" x　　　　　PH为联系电话
　　　　　PR为简介
$ B- |1 w- I- O, S　　　　　PV为省
9 k& z1 _0 p  S& `7 ~　　　　　RN为真实姓名
" K* u* k! h! j. e　　　　　SC为毕业院校
% ~& m7 [$ m$ e! `2 J+ k　　　　　SH为生肖
. v. _; B) f' y4 Z2 x　　　　　SX为性别
　　　　　UN为QQ号
, K9 a* k  j& \; E1 }% i　　　　　NK为昵称
' ]; Q- P# Z1 Y! B
$ c1 {& A) M& _/ O　　　　　血型：0 => '',
　　　　　　　　1 => 'A型',
　　　　　　　　2 => 'B型',
　　　　　　　　3 => 'O型',
　　　　　　　　4 => 'AB型',
) ~! h) u1 t' h4 I8 m' X　　　　　　　　5 => '其他'
0 s0 T5 K- ~  _2 D0 u" q
& {3 Z6 U+ O1 o) U4 v: W+ }! [
* f0 q  s2 V" Q2 ~* s1 d　　　　　星座：0 => '',
　　　　　　　　1 => '水瓶座',
: Z  y8 G, P" F! k! j　　　　　　　　2 => '双鱼座',
/ X4 e% A* E4 a1 ^% }1 _1 a0 E　　　　　　　　3 => '牡羊座',
　　　　　　　　4 => '金牛座',
　　　　　　　　5 => '双子座',
9 }. R8 Z: b5 p1 u5 b　　　　　　　　6 => '巨蟹座',
　　　　　　　　7 => '狮子座',
: ^' J) U& O1 t- B; M; k) i8 v1 `) Y8 ?' J　　　　　　　　8 => '座',
　　　　　　　　9 => '天秤座',
6 B  g+ ?- m# }　　　　　　　　10 => '天蝎座',
　　　　　　　　11 => '射手座',
　　　　　　　　12 => '摩羯座'
8 o% J2 H3 W) t! d  d
/ S2 H+ l3 {8 E+ V　　　　　生肖：0 => '',
4 J" v% v* l% |/ q　　　　　　　　1 => '鼠',
, N+ X* P: R& ]3 R! r2 b7 X) l　　　　　　　　2 => '牛',
　　　　　　　　3 => '虎',
: R, h! z: c2 h) A: M$ H) e　　　　　　　　4 => '兔',
　　　　　　　　5 => '龙',
　　　　　　　　6 => '蛇',
, t) i0 N$ d3 e. Z　　　　　　　　7 => '马',
　　　　　　　　8 => '羊',
　　　　　　　　9 => '猴',
- M4 j' V1 y/ Z　　　　　　　　10 => '鸡',
+ ^5 h: E3 _2 }" ~9 `6 l　　　　　　　　11 => '狗',
　　　　　　　　12 => '猪'

. R9 j) u- n- V" c　　　　　性别：0 => '男',
　　　　　　　　1 => '女'
2 l* w) ~9 q3 _/ ?
(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号(允许被加为好友，此时他已经是你的好友)
' N. ^9 F  S: V( r　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=1&UN=对方QQ号(需要验证)
, Z5 e/ K7 A+ A5 i: N, K　　　　　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为字符)

(5).发送验证
% O* k" G: ]  P  d# L6 T　　说明：1、如果你加对方为好友，你需要发送验证
　　　　　2、对方加你为好友，发送了验证，你要通过或者拒绝
　　　　　这2种情况需要发送验证消息
7 X. z! X6 m* w: B, _
　　提交数据：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号&CD=验证类型&RS=理由
4 G! }1 Y, i- _3 Y$ O　　说明：CD为0表示“通过验证”，CD为1表示“拒决加为对方为好友”，CD为2表示“为请求对方加为好友”。

　　返回：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=0(成功)
3 y6 X( X3 s9 n  ^" \: v1 q  `　　　　　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字符)
　　*如果服务器返回RES=3，那么这次对话的响应时间在20s。当发送验证请求的时候，必须连发2次(请求内容不必一样)，其中一条RES=3，对方收不到，一条RES=0，对方能够收到。当CD>=3时，RES=3，响应时间20s。
- A  A8 x" D  [1 c7 p, f
(6).删除好友
/ \4 p8 v0 `$ f2 z% Y　　提交数据：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&UN=删除的QQ号
, Z$ w" k  v: k+ S7 l" c# D; i" p
; W( M$ j  J& N. S$ P& q　　返回：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=0&(成功)
; o2 W" P+ k1 z' B  c' m　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=3(响应时间30s，重复发送的后果)
/ B8 S7 r% J2 K2 V' L3 @　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、UN为字符)

(7).改变状态
& `- q. G/ V3 K7 l　　提交数据：VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&ST=状态代码
　　说明：状态代码：10为上线，20为离线，30为忙碌，40为隐身，其他视为非法

  y' P4 u2 D4 k- U9 R1 G4 k　　返回：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(没有正确登陆)
　　　　　NULL(UIN为字符，ST非法)

3 n9 X3 e( N8 D1 I6 S/ e　　特别说明：如果你改变好友，将会给所有好友发送一条系统信息，内容就是状态代码；如果隐身，发送的状态代码为20，表示离线。
　　　　　　　同理，当你的好友改变状态，你也会收到一条系统信息。
( m$ A( s! |( f8 h
(9).获得消息
  G4 {, f1 c  \& d+ i3 x　　提交数据：VER=1.1&CMD=GetMsgEx&SEQ=标记&UIN=QQ号
4 w2 a/ a& J4 n
! S$ b0 \" b3 ?: s1 ~; J1 m: M　　返回：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的值用","分割，分别表示消息类型、发送人号码、消息内容)
; E3 l& `3 F% B/ O: R　　　　　VER=1.1&CMD=GETMSGEX&SEQ=标记&UIN=QQ号&RES=0&MN=0&MT=&UN=&MG=(表示没有信息)
8 ?) j  \% z6 i　　　　　VER=1.1&CMD=GETMSGEX&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
6 M; S. @; Q+ L3 I& I$ X$ [4 g% ~　　　　　NULL(UIN为字符)
　　说明：关于MT：
! q# [) o3 q# W* b: F　　　　　　　9为用户消息，99为系统消息，2为请求信息，3为通过验证，4为拒绝被加好友
　　　　　关于MG：
  }8 j$ ?9 x. |0 f* h( [　　　　　　　当MT=9时，MG为用户发送的消息内容
) o& y% T/ w' B! x9 i　　　　　　　当MT=99时,
; T' N& I) B! c! ^2 ~* {' X　　　　　　　　　MG=10(QQ_STATUS_ONLINE)表示对方上线
　　　　　　　　　MG=20(QQ_STATUS_OFFLINE)表示对方下线
　　　　　　　　　MG=30(QQ_STATUS_BUSY)表示对方进入忙碌状态
　　　　　　　当MT=2时，MG为对方请求你验证的信息
　　　　　　　当MT=3时，表示对方通过你的验证
　　　　　　　当MT=4时，MG为对方拒绝你理由

(10).发送消息
. J* ?% Y! N  C  Q+ J6 |8 X　　提交数据：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&UN=对方QQ号&MG=发送内容
/ N: M: Y4 E/ D* F$ v! x$ C; \& {
9 S8 D& P0 o1 q0 V  ^+ ?　　返回：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=0&(成功发送，对方不一定能收到哦)
5 E4 m+ Q' u1 z4 [5 n$ C　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=3(发送过快)
+ p' A) P, h: ]& `　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、UN为字符，MG含非UTF-8字符)
　　说明：1、当你发消息时，以下情形对方可能看不到(其实是收到了，QQ不提示)你发送的消息：
" I+ V4 B. s# e$ Q) P8 o) u　　　　　　　你俩互为陌生人，且对方没有和你说过话
　　　　　　　你在他的陌生人列表里，并且他没有和你说过话(没有验证)
  R, ^  A2 g* W) M! K　　　　　2、当你过快发送消息时，系统会给你一个惩罚，RES=3，相应时间20s
　　　　　3、当我发送含有小写字母h的信息时，服务器有可能返回NULL
; C3 y0 A& w) ^% V" j3 E1 x/ ?
' b7 x* v1 _5 C(11).登出
6 I% h9 i" m( D; \) I0 ^+ W4 z　　提交数据：VER=1.1&CMD=Logout&SEQ=标记&UIN=QQ号
* E$ ~3 m6 d! H) B6 C  N. ^6 j' \
: _" ^" l8 M/ ?1 Z& D. D　　返回：VER=1.1&CMD=LOGOUT&SEQ=标记&UIN=QQ号&RES=0(成功，好像永远成功的，不管你是否登陆)
1 v0 z- s. W0 A2 [: Z4 O! R: e　　　　　NULL(UIN为字符)
- N2 m  P, ^7 h9 R6 C; `! ]/ z2 b
+ e' y/ S5 x: l. d# C8 f* q6 V５、总结
( P7 b% g* v  {+ L& q7 @2 z
  e: J2 m/ E' a5 c. j/ o/ Y/ ~　　通过对照以上的接口说明，我开发出了能够实现基本QQ功能的PHP类，它整合了以上所有的接口，使用更方便，可以开发QQ机器人、群发广告程序等。免费获得类的代码请到
　　http://blog.hackfan.net/index.ph ... d=a_20050819_223558
　　本文撰写时间仓促，难免有误，希望各位不吝赐教
' j% U; m7 C5 g' M* j+ @

Trackback: http://tb.donews.net/TrackBack.aspx?PostId=520301