QQ的HTTP接口探究

天云上人

作者：Hackfan
日期：2005.8.21凌晨
( b# D/ w4 A* g4 n& H9 {! p: O6 }联系：QQ:106814 Email:hackfan@vip.sina.com
+ I8 q* h( q7 [, I2 A: R+ S+ _$ _
１、研究说明
* p6 {8 R) I7 y$ U3 E9 z
　　Tencent在tqq.tencent.com的8000有一个使用HTTP的QQ接口，通过这个接口，可以进行一些基本的操作，如：登陆、登出、改变登陆状态(上线、忙碌、离线、隐身)、添加删除好友、查看好友信息、发送验证信息(接受被加为好友、申请加对方为好友、拒绝被加为好友)、收发用户消息、系统信息。

　　目前我研究的是1.1版本的HTTP QQ协议，研究是微程在的成果上进行的，不敢说有什么超越，只不过更为详细和准确。
3 ?3 d5 l3 u+ ~, G/ f# @) E
3 F  S( w4 e% R; l２、接口说明：

　　接口位置：tqq.tencent.com:8000
　　通信协议：HTTP
　　数据传输方法：POST
　　HTTP请求格式：
: ?4 H, j& z) v+ _' a
7 j% F  V5 g2 H% O' B: Y" a1 q! fPOST HTTP/1.1
; Z1 d. ^( A8 G' K/ p% u1 F, dHost: tqq.tencent.com:8000
Content-Type: text/plain; charset=UTF-8
Content-length: 长度
: \$ f5 B: I' U2 k) @Connection: close
# t1 s/ {* C; U8 d3 c/ v" I
5 G# H" u  F$ i数据

　　其中长度为 数据 的长度，数据的格式：
　　VER=1.1&CMD=命令&SEQ=标记&UIN=QQ号&....

　　以上４个参数是每个请求都必有的。其中，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还需要不同的参数，下面我就公布我的研究成果。

2 s  d+ H7 R. f! ]３、研究方法：
- I3 s3 q% g, e. e& _' V3 @% a
5 J0 ]; C- @6 u. E　　我对目前网上的资料不够满意，就自己写程序，发送多条相同CMD不同参数的请求，根据服务器的返回，来做判断。感兴趣的朋友可以参考一下，此处可以跳过。
　　下面我公布我探测的代码(PHP)：

1. <?
   4 P. w8 I9 d3 {+ E. m
2. $uin = "QQ号";
   
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. /*******
   , |; W+ G. {* r, J: A% G
9. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=0&LC=9326B87B234E7235";
   $ m' V- e* s+ N- X5 r
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";
    
14. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M6=1&LC=1223423545756679";
    ( I9 ]  i$ O9 e8 M$ Z
15. *******/
    ' G8 ^. l% Z6 L* a
16. 
    
17. 
    
18. //得到好友列表
    
19. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin;
    2 Y  o$ p: O: Y) \
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";
    % U# o$ X  Z* `/ d
23. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=".rand(1,10);
    ) }/ V: i" a' \9 o
24. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=0";
    5 v+ Y, d2 T* g  t4 ?- ^" V
25. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    , n) h% [& l. L
26. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    $ P3 X, g8 \8 ?/ T. P+ O0 ~
27. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    4 b/ d0 G6 H% K" g+ v5 p8 G" [4 J
28. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    ( E1 c* \" O5 z, \5 O
29. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    . Z( L7 n/ o. `0 u, v! E/ P# `
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);
    + y8 `, P7 W8 \8 `* x. [7 A
33. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=106814";
    / r# p4 N7 ^3 D- z
34. 
    / B( h, s8 t) o7 N: J2 q$ X
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";
    % a* i# T; @. P' \
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";
    4 b! k4 z8 k. ~" e1 N
40. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=".rand(1,10);
    1 @& C7 \$ j% k) w9 T6 t
41. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=0";
      w$ {  A( ], q7 Z7 P, U# |$ u5 i
42. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    * s7 G) d* X/ @/ z- O
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";
    / d8 Y$ ?2 s7 s4 z
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";
    
47. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    $ A% g, U" e# N9 N7 J
48. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    7 |* M! |* ~: Z. v
49. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    3 V3 B! U& D( a
50. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=106814";
    
51. 
    & z, s  D; }) E2 v% L7 u( P
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";
    3 r3 H% r+ t6 k3 S1 T
55. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=2&UN=106814";
    - z/ b: w/ }8 y
56. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=3&UN=106814";
    0 U; g* Y& B- f1 \' R8 X# X
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";
    ' E7 k. r  W: j
59. 
    
60. //增加好友
    
61. $poststring[] = "VER=1.1&CMD=AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    
62. 
    % G7 L( R  D) E" u+ K8 F. C
63. //发送验证
    ! n1 r5 P! ^: X: z) [) \6 |/ P* g
64. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=0&RS=TEST";
    ; Y1 x- I( `; s
65. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=1&RS=TEST";
    9 z3 o- i1 O9 Q
66. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=2&RS=TEST";
    4 L4 d8 Q6 G  d- E" |$ f
67. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=3&RS=TEST";
    0 p' p0 u: s5 O6 L/ k" y& k
68. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=4&RS=TEST";
    1 ^. z8 S/ \8 Z" I1 A: s6 L, t8 t
69. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=5&RS=TEST";
    7 [( d- A$ u% z9 H& B
70. 
    2 {. W( A0 [4 i9 V) I0 T) Y4 r# v
71. //删除好友
    3 B% W# M7 c7 q0 {
72. $poststring[] = "VER=1.1&CMD=DelFromList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    
73. 
    / T. \# n0 h+ w& j% ]1 P
74. //改变状态
    
75. for($i=0;$i<=60;$i=$i+5)
    5 }) p& C, J* X/ |6 S
76. {
    " Z' U1 |" J' s& j5 |
77. $poststring[] = "VER=1.1&CMD=Change_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&ST=".$i;
    5 F( A3 H% d) F4 {4 m& t9 c
78. }
    
79. 
    
80. //获得消息
    : v0 Y; h7 e" M* E9 W, K
81. $poststring[] = "VER=1.1&CMD=GetMsgEx&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    
82. 
    : S! T% c7 s8 V4 [7 ]- q9 }
83. //发送消息
    / e  L/ C. V% H* A
84. $poststring[] = "VER=1.1&CMD=CLTMSG&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&MG=TEST";
    4 ?0 g1 y6 W2 p+ ?, }' h
85. 
    4 g2 k/ @6 Q- y% x, ?
86. //登出
    5 r5 ^( d' C; @* E$ R  `
87. $poststring[] = "VER=1.1&CMD=Logout&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    
88. 
    " I+ j  i" L0 Y; J) t' ?. q5 Q  d+ I% d
89. $file = fopen("p.txt","w");
    
90. 
    
91. foreach($poststring as $k=>$v)
    
92. {
    . e* t1 n+ }- Y) u6 I$ u
93. ss_timing_start();
    
94. $fp = fsockopen('tqq.tencent.com', '8000', $errno, $errstr, $timeout = 10);  
    , p6 d" ]: b" U3 d7 j5 ?9 ~
95. 
    
96. if(!$fp){  
    ; Z0 ^, t, E/ h- b; R, v% Y. D
97. //error tell us  
    
98. $content = $k.chr(13).chr(10)."ERROR:$errstr ($errno)";  
    
99.    
    
100. }else{  
     + ]+ ]. q8 o# O' G3 ?/ k& u* Z& @' d+ p
101. 
     " u1 V# B* B( A: i9 j' r7 a0 \
102.   //send the server request  
     * l" i7 L5 U9 B) A2 w
103.   fputs($fp, "POST HTTP/1.1\r\n");  
     2 C3 _! w  D% z
104. //  fputs($fp, "Host: $host\r\n");  
     
105. //  fputs($fp, "Content-type: application/x-www-form-urlencoded\r\n");  
     5 e* G' r, n. C5 ?
106.   fputs($fp, "Content-length: ".strlen($v)."\r\n");  
     7 ?6 Z! k( B7 P" p1 x  d
107.   fputs($fp, "Connection: close\r\n\r\n");  
     0 e8 K/ c7 O1 N/ K) l
108.   fputs($fp, $v . "\r\n\r\n");  
     
109. 
       Y: O* j8 d9 W" ]+ S& ?
110.   //loop through the response from the server  
     
111.   $res = "";
     9 N9 h" S* s+ {, i7 B# }
112.   while(!feof($fp)) {  
     
113.   $res .= fgets($fp, 4096);  
     
114.   }  
       W) K2 g2 v  y6 u5 L
115.   //close fp - we are done with it  
     
116.   fclose($fp);  
     
117. 
     
118.   $content = $v.chr(13).chr(10).$res;
     7 D9 V, Y! g: M0 D1 L% L# L7 U
119. }  
     , i0 l$ l" i3 e0 s1 `
120. ss_timing_stop();  
     5 b9 r0 [+ s5 [. O' }& A- _8 ?) H
121. $content .= chr(13).chr(10)."Time: ".ss_timing_current().chr(13).chr(10)."--------------------------------------".chr(13).chr(10);
     0 G8 A8 k7 y5 ^  Q5 z) t
122. fputs($file,$content);
     8 D9 S% w1 K, j+ T* R* t
123. }
     
124. fclose($file);
     - `% H( p) ]. A1 P( @  u
125. ?>
     
126. <?
     
127. function ss_timing_start ($name = "default") {  
     
128. global $ss_timing_start_times;  
     
129. $ss_timing_start_times[$name] = explode(' ', microtime());  
     
130. }  
     
131. function ss_timing_stop ($name = "default") {  
       _: S7 B) I- q/ e0 X/ x
132. global $ss_timing_stop_times;  
     
133. $ss_timing_stop_times[$name] = explode(' ', microtime());  
     4 u& I4 V$ Z! P
134. }  
     
135. function ss_timing_current ($name = "default") {  
     % o# C( x9 x( ]6 H
136. global $ss_timing_start_times, $ss_timing_stop_times;  
     
137. if (!isset($ss_timing_start_times[$name])) {  
     : o; G  s9 B; c' t2 E& Y& e
138. return 0;  
     8 g  ~3 v; o- F( q
139. }  
     
140. if (!isset($ss_timing_stop_times[$name])) {  
     1 C0 ~, L1 Y7 x- R( K
141. $stop_time = explode(' ', microtime());  
     
142. }  
     
143. else {  
     3 P" K# \' I* X6 {/ g2 Y
144. $stop_time = $ss_timing_stop_times[$name];  
     5 ?" m$ q; J, ^- X) Q2 C- I7 A
145. }  
     $ g- ?1 B! U, v$ l  O' e- h- [
146. $current  =  $stop_time[1]-$ss_timing_start_times[$name][1];  
     
147. $current += $stop_time[0]-$ss_timing_start_times[$name][0];  
     
148. return $current;  
     
149. }  
     ; Y  a" W6 O/ ?4 p, j
150. ?>

复制代码

6 X9 X# e4 |" |9 _４、研究成果：

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

　　提交数据：VER=1.1&CMD=Login&SEQ=标记&UIN=QQ号&PS=QQ密码&M5=1&LC=9326B87B234E7235
+ k; u# A" ?" T5 P+ ?　　说明：QQ密码是通过md5加密的字符串，在PHP中可以直接用md5()进行加密；
& }" }# I# A8 a　　　　　M5这个参数的作用还不清楚，但最好为1。
6 g. u+ r1 {  l  h: Q　　　　　LC这个参数有点神秘，不能有丝毫改动，不然服务器就没有响应(没有响应就是返回NULL)。
0 n) a( Q( ~- [9 N) a, h2 o
, m* @6 a6 e) l+ U% t  o　　返回：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=密码错误(密码错误)
　　　　　VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=5(QQ号非法，如100)
　　　　　NULL(UIN为字符、PS为空、LC错误)
6 p( C; w8 M, I$ N
* {! Q, @- A# S4 Y+ ^1 S(2).得到好友列表
/ j+ y; K0 P' i; O  {　　提交数据：VER=1.1&CMD=List&SEQ=标记&UIN=QQ号&TN=160&UN=0
! n! s+ j. {( u1 V. B) z+ c% Y$ R　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响
4 Z' q9 Z) I8 R& P) M
　　返回：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(没有正确登陆)
7 h( u: Y" m: V　　　　　NULL(UIN、TN、UN为字符)

3 y) L# w) t# a0 L% }: s9 o5 z(3).得到在线好友列表
1 }% F/ a0 ?" ^/ T　　提交数据：VER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号&TN=50&UN=0
　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响
  d" x3 L7 x$ x. m4 X
- d, c9 E3 n$ W2 m$ ~　　返回：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的值用','分割，分别表示头像、状态、号码、昵称)
& N* h1 `! ^$ C/ a　　　　　VER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
2 u% _% t- \& H: Y2 B　　　　　NULL(UIN、TN、UN为字符)
　　说明：FC为QQ头像的的ID，如的头像ID为270，那么其头使用的图片为91.bmp,其算法为ID/3+1；
　　　　　ST为QQ用户的状态，10为上线，20为离线(或隐身)，30为忙碌；

" B# C$ S4 J- z4 `1 O- b　　特别说明：当参数TN=0或不存在时，服务器返回：
VER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号
2 x3 Q  e* W0 \7 U& [HTTP/1.1 200 OK
Server: tencent imserver/1.0.0
0 n& z! P6 X6 Y  B: cContent-Type: text/plain; charset=UTF-8
Content-Length: 56
# G9 e- ~# J5 X4 h/ l. `
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
Content-Length: 77
+ R2 p7 s9 s8 Q+ ]& Z
VER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FC=&FN=1&SN=0&ST=&UN=&NK=
　　返回了２次，第一次的结果中，FN为在线好友数，第二次返回的数据基本没用。
, h7 C9 T: @( s/ ~& X$ D
; y& {" c0 k5 R( s' }5 i" U(4).查看好友信息
) C' `* u  @; {3 v/ B, r　　提交数据：VER=1.1&CMD=GetInfo&SEQ=标记&UIN=QQ号&LV=查询类型&UN=被查询QQ号码
" F; y) x# H+ A/ }' v　　说明：LV=0,1为精简查询，LV=2为普通查询，LV>=3为详细查询

　　返回：VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=0&LV=0&UN=106814&NK=Hackfan 好(精简查询)
' Y9 ]* g- K/ g　　　　　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=学生
: e- \' v# u. d&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  
" r, C+ @: o' r# ]updating to .NET Frameword......&PV=江苏&RN=胡吉阳&SC=毕业院校&SH=3&SX=0&UN=106814&NK=Hackfan 好(详细查询)
) ~. l1 O0 K2 M/ A　　　　　VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
; T9 @3 |, B8 [5 l% H# n  Y　　　　　NULL(UIN、LV、UN为字符)
: R* T4 e- ~) b
　　说明：AD为联系地址
　　　　　AG为年龄
. |4 k& ?2 `  _6 l3 l　　　　　BT为血型
& h. W/ V' O$ |2 ]$ m　　　　　CO为星座
/ Z9 _& D% D& w, S. z　　　　　CT为城市
　　　　　CV为未知*
7 A' P: e9 A+ \& B　　　　　CY为国家
" D! ?8 B, g. M/ E　　　　　EM为Email
　　　　　FC为头像
　　　　　HP为网站
　　　　　ID为未知
　　　　　JB为职业
4 u! T7 ?) j0 ]) ^6 T! t　　　　　LV为查询代码(就是发送的LV)
) b; h$ z4 ?3 v# N4 F　　　　　MO为移动电话
0 q8 j% ]  i6 E6 ^　　　　　MT为未知
　　　　　MV为未知
/ `) [7 @+ I1 w* H) ?& S　　　　　PC为邮编
# F6 _" q- N7 B& ~+ f7 a+ m/ @　　　　　PH为联系电话
; U8 N7 ~+ k$ r$ g　　　　　PR为简介
$ _) H: s) z2 U0 k　　　　　PV为省
　　　　　RN为真实姓名
) M, t' T: N3 V8 d+ Y　　　　　SC为毕业院校
　　　　　SH为生肖
　　　　　SX为性别
& W) ~, T! w8 N" d& A& z　　　　　UN为QQ号
5 d8 \1 w/ b. G* C2 Q8 G　　　　　NK为昵称

* n$ O5 d6 ]) |9 e7 B) V　　　　　血型：0 => '',
% o" _) s% F) r" C; Q! Q" o1 n& o　　　　　　　　1 => 'A型',
　　　　　　　　2 => 'B型',
1 e+ q2 t7 V# `% F  {/ k　　　　　　　　3 => 'O型',
+ i2 |, r2 d9 [  i: K. R: z　　　　　　　　4 => 'AB型',
; e! x- t6 j. e+ G8 D( Q( D* ^　　　　　　　　5 => '其他'
# E' c1 d1 I. G: \$ n4 \3 N
; l; J, y! O" @9 t3 ]
0 w% c( O/ B% ]7 u8 _　　　　　星座：0 => '',
　　　　　　　　1 => '水瓶座',
　　　　　　　　2 => '双鱼座',
5 ]- h( k, D( F9 C+ C　　　　　　　　3 => '牡羊座',
　　　　　　　　4 => '金牛座',
　　　　　　　　5 => '双子座',
　　　　　　　　6 => '巨蟹座',
7 {$ i& p* v, P' N　　　　　　　　7 => '狮子座',
5 y% ^( g7 f: d, U　　　　　　　　8 => '座',
　　　　　　　　9 => '天秤座',
　　　　　　　　10 => '天蝎座',
　　　　　　　　11 => '射手座',
　　　　　　　　12 => '摩羯座'
1 r8 \& P* e9 L9 v! Q6 b4 H: g9 E
　　　　　生肖：0 => '',
　　　　　　　　1 => '鼠',
　　　　　　　　2 => '牛',
　　　　　　　　3 => '虎',
　　　　　　　　4 => '兔',
1 ~/ D" n- P& C1 Y2 I$ u7 K# H　　　　　　　　5 => '龙',
　　　　　　　　6 => '蛇',
　　　　　　　　7 => '马',
3 o! q6 q! w. q" @3 Q+ L- _& h5 u　　　　　　　　8 => '羊',
　　　　　　　　9 => '猴',
0 s0 u, O" B! e5 C& h2 w. K7 d　　　　　　　　10 => '鸡',
9 g' _  S3 {% S& X% |& M+ _　　　　　　　　11 => '狗',
3 L" t4 i8 v4 ?　　　　　　　　12 => '猪'

　　　　　性别：0 => '男',
% V4 ]. n! T+ g/ R1 O8 M7 |- ^, G　　　　　　　　1 => '女'
& w) X. B: e+ x6 G* X
(5).增加好友
　　提交数据：VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号
7 E4 l/ d4 h2 G/ ~5 _9 U
( _( y& Q7 ^& E- g- z4 k　　返回：VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=0&UN=对方QQ号(允许被加为好友，此时他已经是你的好友)
4 s. x/ `5 \( S% A- U7 p: Y　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=1&UN=对方QQ号(需要验证)
　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=2&UN=对方QQ号(决绝被加为好友)
+ ?  d: S( x: P; J+ z; u6 d　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
# @2 Z# ^: j+ L; I" H　　　　　NULL(UIN、UN为字符)
9 K$ B  @" _* w0 U) ?6 d
* i; A6 I  ~  ~4 R  \' e3 j(5).发送验证
　　说明：1、如果你加对方为好友，你需要发送验证
7 V& ~$ E; l$ Q- c　　　　　2、对方加你为好友，发送了验证，你要通过或者拒绝
8 Z) K* ?8 x! P  i" K9 A. ?　　　　　这2种情况需要发送验证消息
2 d6 G  G& `3 i7 v- k4 _
　　提交数据：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号&CD=验证类型&RS=理由
　　说明：CD为0表示“通过验证”，CD为1表示“拒决加为对方为好友”，CD为2表示“为请求对方加为好友”。
/ v3 S3 r5 Q6 }( u5 a$ n0 l6 F
　　返回：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=0(成功)
! G7 Q; n$ A$ \3 J: ]/ \$ D( `　　　　　VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=3(*)
; I: B' J0 w5 h, w　　　　　VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
' `: c( N; T: O; {　　　　　NULL(UIN、UN、CD为字符，RS为非UTF-8字符)
　　*如果服务器返回RES=3，那么这次对话的响应时间在20s。当发送验证请求的时候，必须连发2次(请求内容不必一样)，其中一条RES=3，对方收不到，一条RES=0，对方能够收到。当CD>=3时，RES=3，响应时间20s。
. M! E. D* ]- A) ~4 A' E, s
5 a1 {3 G0 u- l/ J(6).删除好友
　　提交数据：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&UN=删除的QQ号

, p" d% w7 x: }" X2 ~* J; [　　返回：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=0&(成功)
　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=3(响应时间30s，重复发送的后果)
　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
4 E: W0 L( T0 F& n/ o　　　　　NULL(UIN、UN为字符)

(7).改变状态
　　提交数据：VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&ST=状态代码
" M5 Y! _/ ^1 m4 r. r, U7 I　　说明：状态代码：10为上线，20为离线，30为忙碌，40为隐身，其他视为非法
0 n0 }" u3 U& `
8 G  c5 }$ r  D! a0 ~8 H　　返回：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(没有正确登陆)
7 |- W: ^  E5 a( l+ _　　　　　NULL(UIN为字符，ST非法)
0 v: q& j1 w7 l
) l4 p3 J2 l$ }7 {, I　　特别说明：如果你改变好友，将会给所有好友发送一条系统信息，内容就是状态代码；如果隐身，发送的状态代码为20，表示离线。
) H: w+ W( }, M8 ~, Q- }2 n　　　　　　　同理，当你的好友改变状态，你也会收到一条系统信息。
8 }3 T9 U+ Q0 N2 [& W# |1 y( n) R
5 Z( Y% a: ~9 e" j/ U- g4 C% Z(9).获得消息
　　提交数据：VER=1.1&CMD=GetMsgEx&SEQ=标记&UIN=QQ号
* [; z" u% T. r  @  f
# q! a, j6 h* r6 I/ D" g4 [$ l, Y$ p　　返回：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的值用","分割，分别表示消息类型、发送人号码、消息内容)
6 H" K7 k1 G& z9 o/ R& N- o　　　　　VER=1.1&CMD=GETMSGEX&SEQ=标记&UIN=QQ号&RES=0&MN=0&MT=&UN=&MG=(表示没有信息)
6 O# c& n! a8 a# n0 o9 B' e( Q2 U　　　　　VER=1.1&CMD=GETMSGEX&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
8 ~3 G3 m: C/ w# s6 w　　　　　NULL(UIN为字符)
( j* |( g% L/ E/ i　　说明：关于MT：
( K4 B6 g; }5 L8 a4 i　　　　　　　9为用户消息，99为系统消息，2为请求信息，3为通过验证，4为拒绝被加好友
+ y& K  p0 r3 S7 s  b　　　　　关于MG：
9 j) e9 }0 ~/ R! ?　　　　　　　当MT=9时，MG为用户发送的消息内容
" n, z% S% p8 O. f　　　　　　　当MT=99时,
　　　　　　　　　MG=10(QQ_STATUS_ONLINE)表示对方上线
; D2 V, @4 }. m. `: C2 g　　　　　　　　　MG=20(QQ_STATUS_OFFLINE)表示对方下线
5 X+ s+ f7 w8 y3 Q- [* p　　　　　　　　　MG=30(QQ_STATUS_BUSY)表示对方进入忙碌状态
　　　　　　　当MT=2时，MG为对方请求你验证的信息
　　　　　　　当MT=3时，表示对方通过你的验证
　　　　　　　当MT=4时，MG为对方拒绝你理由
3 |2 }1 @# X  p7 K; X$ a) x
(10).发送消息
, R% K4 U8 }+ C, H+ m　　提交数据：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&UN=对方QQ号&MG=发送内容
( d4 `' Y$ W* h1 A- J4 {/ J4 H8 w
　　返回：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=0&(成功发送，对方不一定能收到哦)
　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=3(发送过快)
) t1 l2 |0 T$ K' I) {& ]! E% p　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
: G- }% y- O9 N6 V3 v1 C9 ^　　　　　NULL(UIN、UN为字符，MG含非UTF-8字符)
6 K8 Z" T" S* E, S) B8 Q! y6 b& ]　　说明：1、当你发消息时，以下情形对方可能看不到(其实是收到了，QQ不提示)你发送的消息：
　　　　　　　你俩互为陌生人，且对方没有和你说过话
& @" U* _  O$ \0 _( T0 S  }　　　　　　　你在他的陌生人列表里，并且他没有和你说过话(没有验证)
% l4 t4 Y- D7 S# P9 f6 U& E1 {) n" q　　　　　2、当你过快发送消息时，系统会给你一个惩罚，RES=3，相应时间20s
　　　　　3、当我发送含有小写字母h的信息时，服务器有可能返回NULL
% x. j3 @' I* Y: a+ U/ T
(11).登出
　　提交数据：VER=1.1&CMD=Logout&SEQ=标记&UIN=QQ号

　　返回：VER=1.1&CMD=LOGOUT&SEQ=标记&UIN=QQ号&RES=0(成功，好像永远成功的，不管你是否登陆)
　　　　　NULL(UIN为字符)

５、总结
+ ?$ Q# w# L% U( o  {( ^
  p5 R' o5 _; m: j" y　　通过对照以上的接口说明，我开发出了能够实现基本QQ功能的PHP类，它整合了以上所有的接口，使用更方便，可以开发QQ机器人、群发广告程序等。免费获得类的代码请到
　　http://blog.hackfan.net/index.ph ... d=a_20050819_223558
* J# b% y9 Z. @1 G. p. k& Q3 _# E; z　　本文撰写时间仓促，难免有误，希望各位不吝赐教
7 M1 i7 F4 K" p% `" H7 P
: M& c/ n6 J  p% d( z
* T! c$ m; Q0 D1 @Trackback: http://tb.donews.net/TrackBack.aspx?PostId=520301