QQ的HTTP接口探究

天云上人

作者：Hackfan
% g3 \: t: r1 I  F日期：2005.8.21凌晨
6 ^% D6 y# V+ [! i联系：QQ:106814 Email:hackfan@vip.sina.com

１、研究说明

7 G2 q. s' z% A& L9 M, ?　　Tencent在tqq.tencent.com的8000有一个使用HTTP的QQ接口，通过这个接口，可以进行一些基本的操作，如：登陆、登出、改变登陆状态(上线、忙碌、离线、隐身)、添加删除好友、查看好友信息、发送验证信息(接受被加为好友、申请加对方为好友、拒绝被加为好友)、收发用户消息、系统信息。
% [+ @3 }7 y4 X3 `3 d- O+ w2 I/ K
　　目前我研究的是1.1版本的HTTP QQ协议，研究是微程在的成果上进行的，不敢说有什么超越，只不过更为详细和准确。
" ^; N9 `2 [8 s7 X- d
# d  Q( C5 G0 h5 M２、接口说明：

　　接口位置：tqq.tencent.com:8000
　　通信协议：HTTP
　　数据传输方法：POST
. u- p6 i* A4 l9 b+ y4 Z　　HTTP请求格式：

POST HTTP/1.1
Host: tqq.tencent.com:8000
/ p! y! z" Q9 ]: A- |Content-Type: text/plain; charset=UTF-8
2 V) k( u- J6 B& C4 n4 P/ Q. f( H2 OContent-length: 长度
Connection: close
. l/ m  u1 Z# Z4 S+ }
9 H, }* \- h7 {- B+ k数据
$ j4 E7 p+ P& \. Y) K
- ~- Z9 N$ f) p% J　　其中长度为 数据 的长度，数据的格式：
) U  L1 P7 {8 s2 B　　VER=1.1&CMD=命令&SEQ=标记&UIN=QQ号&....

; S- f3 N1 ~' P; j7 g+ ^* V8 B. a　　以上４个参数是每个请求都必有的。其中，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还需要不同的参数，下面我就公布我的研究成果。
% ]& B# a8 n% [7 v: e# r
  q7 f; d, O: d8 K３、研究方法：
! Y3 u" H& o, ~0 D
9 P1 M) h  f% e* s　　我对目前网上的资料不够满意，就自己写程序，发送多条相同CMD不同参数的请求，根据服务器的返回，来做判断。感兴趣的朋友可以参考一下，此处可以跳过。
　　下面我公布我探测的代码(PHP)：

1. <?
   % E$ ^! n3 _2 z5 r' N/ P8 _
2. $uin = "QQ号";
   
3. $pwd = md5("QQ密码");
   
4. 
   # i) ]4 \, v4 k3 X$ t* v; x
5. //登陆测试
   " k; D: ]) O( U; x# F) ?: _
6. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=1&LC=9326B87B234E7235";
   1 V0 |8 |- {, F4 h: v: ?! i
7. //注意：登陆测试不能同时进行，必须等到服务器认为QQ断开了，才能够测试，不然结果不可信
   2 H, e- i9 Q0 W
8. /*******
   ( v/ Q- X3 G+ ?! M; Y) l
9. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=0&LC=9326B87B234E7235";
   1 h2 J# h6 {7 C* M3 A: |
10. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=1&LC=9326B87B234E7235";
    * ]3 Z3 Y; A9 I: A. P: c- ~
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";
    0 y+ ~- ~5 u8 H  F/ M6 I
15. *******/
    
16. 
    6 B. T5 s* N, C% k8 D
17. 
    ( r- b4 n* _: ]; E8 z9 r  J
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";
    
23. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=".rand(1,10);
    + W, e; R0 d2 k& S8 V. c
24. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=0";
    / p4 h1 {6 `* [: f7 x; M, T8 P' l
25. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    1 |' p7 E0 u3 N7 f/ M7 `) p
26. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    $ C: R" m1 b( {2 g# M4 O
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";
    
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);
    
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. 
    1 z! I' N4 ]! p, C! T, @
35. //得到在线列表
    5 t) m( z; L7 b/ ?
36. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin;
    0 b  X3 T4 }! _1 E
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";
    3 D6 U2 P" C; H( N$ S: A
40. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=".rand(1,10);
    : Y. t. I/ |. M, y; v
41. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=0";
    4 }3 S/ U1 F" {9 O- [/ b( n
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";
    " i4 ^% M* |& k" d% B& D3 _
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";
    ! |/ \+ v5 j- Y3 L5 J/ l: C
47. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    ) V/ H5 f: {  f7 v& P9 h/ M
48. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    6 x$ H/ c/ q  y+ d0 N1 l8 l! l# d$ `
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. 
    , e" Q- i8 H! ]2 \  T8 d
52. //查看好友信息
    6 E$ O, ^6 X- Z- G. R
53. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=0&UN=106814";
    8 l& f0 G5 j" R7 V9 e1 W
54. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=1&UN=106814";
    2 F$ ^) ]+ F. x
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";
    # z, R# y2 U  S1 M. U4 x' _' N
57. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=4&UN=106814";
    7 c( z! J& n5 |6 u( P3 T
58. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=5&UN=106814";
    
59. 
    
60. //增加好友
    
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";
    ' r# N/ J- m: O
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";
    + O7 Y( j2 z! Q0 k. n
67. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=3&RS=TEST";
    0 D& k3 l7 _9 x3 }' s
68. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=4&RS=TEST";
    6 Y3 A& j  T/ w  X
69. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=5&RS=TEST";
    ' y/ h& D1 i& x" M6 a
70. 
    # R1 ~+ h8 j; w
71. //删除好友
    1 D$ m2 {/ l0 y0 X# I6 M
72. $poststring[] = "VER=1.1&CMD=DelFromList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    
73. 
    * K9 I3 c( L+ P) A6 K+ o
74. //改变状态
    ' @3 l1 ~; ]7 L8 o+ z
75. for($i=0;$i<=60;$i=$i+5)
    ( l- t* n% E- D! l' Q, M' m2 I
76. {
    . B1 I" `/ K: C9 i
77. $poststring[] = "VER=1.1&CMD=Change_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&ST=".$i;
    
78. }
    / j6 T$ A/ Z9 v% f+ U
79. 
    
80. //获得消息
    
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. //登出
    
87. $poststring[] = "VER=1.1&CMD=Logout&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    % I1 \& ]. n: A8 \+ ]
88. 
    9 G: B2 |- p! ?/ ~% m+ x
89. $file = fopen("p.txt","w");
    $ F; a' {. r" f
90. 
    
91. foreach($poststring as $k=>$v)
    ! ~7 j/ ~( B1 c& j! h
92. {
    
93. ss_timing_start();
    
94. $fp = fsockopen('tqq.tencent.com', '8000', $errno, $errstr, $timeout = 10);  
    3 T7 L) a9 \2 q( e1 ^. V
95. 
    ' D! x5 [0 X( L7 c  r+ H5 A: \0 o5 d
96. if(!$fp){  
    3 `8 G, G5 N" w. P$ L% ?+ m2 d
97. //error tell us  
    
98. $content = $k.chr(13).chr(10)."ERROR:$errstr ($errno)";  
    / y' G; z( E) u; G
99.    
    3 ?( u; G! X" `# S( O3 [  P
100. }else{  
     , h, H, s. ^9 t0 k. i& Y  Z" U3 S
101. 
     
102.   //send the server request  
     
103.   fputs($fp, "POST HTTP/1.1\r\n");  
     # T. y/ c  f/ w. Q
104. //  fputs($fp, "Host: $host\r\n");  
       w+ \: a/ P, P
105. //  fputs($fp, "Content-type: application/x-www-form-urlencoded\r\n");  
     " ^- ^+ v5 i8 }4 W$ B0 w( f9 W
106.   fputs($fp, "Content-length: ".strlen($v)."\r\n");  
     
107.   fputs($fp, "Connection: close\r\n\r\n");  
     8 |) b4 l- y" h! N/ J4 M* D
108.   fputs($fp, $v . "\r\n\r\n");  
     9 L. G7 h! H9 |' O5 z$ d' F
109. 
     ! t9 O; K0 C; `1 I* \5 o
110.   //loop through the response from the server  
     0 @4 d1 ^) k4 Q$ @5 G1 _7 I
111.   $res = "";
       e; r3 K% b, ^- S  S
112.   while(!feof($fp)) {  
     * I! X4 j4 e: P' T; l  D4 I; ^
113.   $res .= fgets($fp, 4096);  
     " a2 [4 M* m5 f- ~
114.   }  
     1 g/ m4 v% c# H: E$ s0 E# ]0 J9 @
115.   //close fp - we are done with it  
     2 i! S9 U' L  l6 s0 Y! P
116.   fclose($fp);  
     
117. 
     7 ?) @* m) |; i: L: Z5 F
118.   $content = $v.chr(13).chr(10).$res;
     $ Z. w, g$ D2 e/ L) g
119. }  
     
120. ss_timing_stop();  
     
121. $content .= chr(13).chr(10)."Time: ".ss_timing_current().chr(13).chr(10)."--------------------------------------".chr(13).chr(10);
     # ^$ x) f$ m/ u7 u7 y
122. fputs($file,$content);
     
123. }
     
124. fclose($file);
     
125. ?>
     
126. <?
     $ U' x  M4 u6 L
127. function ss_timing_start ($name = "default") {  
     
128. global $ss_timing_start_times;  
     
129. $ss_timing_start_times[$name] = explode(' ', microtime());  
     7 L7 J* v" Z  z6 j, @0 N. W
130. }  
     
131. function ss_timing_stop ($name = "default") {  
     
132. global $ss_timing_stop_times;  
     
133. $ss_timing_stop_times[$name] = explode(' ', microtime());  
     
134. }  
     
135. function ss_timing_current ($name = "default") {  
     
136. global $ss_timing_start_times, $ss_timing_stop_times;  
     6 N8 R! h3 l& h' j2 R2 [
137. if (!isset($ss_timing_start_times[$name])) {  
     
138. return 0;  
     
139. }  
     " \. q) E& X$ B8 o* ]
140. if (!isset($ss_timing_stop_times[$name])) {  
     
141. $stop_time = explode(' ', microtime());  
     
142. }  
     
143. else {  
     5 {9 }0 v3 W% k/ [
144. $stop_time = $ss_timing_stop_times[$name];  
     + r9 v/ G9 t: d, j7 m
145. }  
     
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. }  
     0 [; t7 c4 M0 N( ^
150. ?>

复制代码

2 A' Q# H" Z) j: S４、研究成果：

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

* s/ R5 B/ \/ Q- O) H　　提交数据：VER=1.1&CMD=Login&SEQ=标记&UIN=QQ号&PS=QQ密码&M5=1&LC=9326B87B234E7235
% R/ r/ e7 n/ D# C0 O　　说明：QQ密码是通过md5加密的字符串，在PHP中可以直接用md5()进行加密；
. Z8 e5 L: P5 S) O　　　　　M5这个参数的作用还不清楚，但最好为1。
　　　　　LC这个参数有点神秘，不能有丝毫改动，不然服务器就没有响应(没有响应就是返回NULL)。

' M% c4 ~" y4 ^' q/ k2 e　　返回：VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=0&RS=0&HI=60&LI=300(成功)
! U* v0 V# B, g" \  G　　　　　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)
" t$ h( }; k3 f$ Q) z　　　　　NULL(UIN为字符、PS为空、LC错误)
8 _0 G0 J4 N+ W- f# p
(2).得到好友列表
3 c; w7 j9 v/ K4 Q' ^　　提交数据：VER=1.1&CMD=List&SEQ=标记&UIN=QQ号&TN=160&UN=0
　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响

9 ]$ I5 c0 P6 L8 _$ H8 W3 U　　返回：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为好友列表，用","分割)
/ v; X+ |9 G: \: I1 x$ P# S& s' d　　　　　VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
& M5 c6 q2 F; x( a　　　　　NULL(UIN、TN、UN为字符)
) ~1 \3 V! Y  f! J. v$ C
9 M% Q6 h" T# J4 g6 K(3).得到在线好友列表
　　提交数据：VER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号&TN=50&UN=0
) e: E. s9 M; T! C/ _5 H, K　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响
7 q1 K# ]  z% F
& o& W) c+ j: k　　返回：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的值用','分割，分别表示头像、状态、号码、昵称)
- ^- H$ h5 l' \　　　　　VER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
1 m% y: H/ x# A( a6 J* K$ T# e　　　　　NULL(UIN、TN、UN为字符)
8 u  j8 j1 k0 Z/ c- O　　说明：FC为QQ头像的的ID，如的头像ID为270，那么其头使用的图片为91.bmp,其算法为ID/3+1；
　　　　　ST为QQ用户的状态，10为上线，20为离线(或隐身)，30为忙碌；
  _, K2 }8 t. Y/ F3 e) X: B8 s
　　特别说明：当参数TN=0或不存在时，服务器返回：
0 u8 h3 ~( c/ F- a1 _VER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号
HTTP/1.1 200 OK
Server: tencent imserver/1.0.0
% }8 O+ Y' Y) x7 a  J8 |) O3 a+ OContent-Type: text/plain; charset=UTF-8
9 R2 {4 n& j1 B4 Z9 s; v' HContent-Length: 56
$ Z9 e2 e& C6 K; T& @, A2 b  l
VER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FN=1
HTTP/1.1 200 OK
2 c" W0 z9 m& m9 ?3 r  R& EServer: tencent imserver/1.0.0
Content-Type: text/plain; charset=UTF-8
Content-Length: 77

+ X9 e1 d/ y: K" zVER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FC=&FN=1&SN=0&ST=&UN=&NK=
　　返回了２次，第一次的结果中，FN为在线好友数，第二次返回的数据基本没用。

3 Q7 D' c+ A% v8 M+ W! Z(4).查看好友信息
　　提交数据：VER=1.1&CMD=GetInfo&SEQ=标记&UIN=QQ号&LV=查询类型&UN=被查询QQ号码
3 Z& s9 R% V/ ]3 e8 h2 K　　说明：LV=0,1为精简查询，LV=2为普通查询，LV>=3为详细查询
$ r8 f5 C3 t" d( M
　　返回：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  
% P- D: v2 C1 n- e  Q) }好(普通查询)
　　　　　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 好(详细查询)
　　　　　VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
8 X% ]3 f7 f2 T8 m' l8 r1 b5 g1 o　　　　　NULL(UIN、LV、UN为字符)
! j) f6 o* t2 f; E
　　说明：AD为联系地址
　　　　　AG为年龄
9 P* Y- }2 G0 H& [7 D　　　　　BT为血型
# @: T# z, N# c$ n6 h+ [5 I　　　　　CO为星座
　　　　　CT为城市
$ k2 K1 p$ y' s  ?+ y1 t: q　　　　　CV为未知*
! n2 y9 O* u7 V0 ]　　　　　CY为国家
　　　　　EM为Email
+ W4 U9 h, H8 _　　　　　FC为头像
* y% k& h8 m& G　　　　　HP为网站
1 p' e2 y1 q" Q3 `　　　　　ID为未知
　　　　　JB为职业
　　　　　LV为查询代码(就是发送的LV)
: R. M6 v& T$ B　　　　　MO为移动电话
　　　　　MT为未知
　　　　　MV为未知
　　　　　PC为邮编
+ r+ D# m9 A) N, B& ~3 ]; S　　　　　PH为联系电话
: ^' t3 h+ j, [  v& M0 A　　　　　PR为简介
) M+ s4 |7 y. L7 }4 j0 [( Z9 ?　　　　　PV为省
' \+ w4 r: }; U' F　　　　　RN为真实姓名
　　　　　SC为毕业院校
7 G  f  H- b4 S# N! k　　　　　SH为生肖
　　　　　SX为性别
　　　　　UN为QQ号
　　　　　NK为昵称

　　　　　血型：0 => '',
　　　　　　　　1 => 'A型',
5 g9 I. W$ G6 F　　　　　　　　2 => 'B型',
. M) L" z1 u- T+ n. w! W6 W1 p　　　　　　　　3 => 'O型',
　　　　　　　　4 => 'AB型',
　　　　　　　　5 => '其他'
7 _# J( d4 O1 h! V' S6 A
6 H+ I) R. N+ d
2 @, G$ K, K" G" t. u9 B1 ^　　　　　星座：0 => '',
　　　　　　　　1 => '水瓶座',
　　　　　　　　2 => '双鱼座',
　　　　　　　　3 => '牡羊座',
' F; Q. E0 F$ G7 u4 }　　　　　　　　4 => '金牛座',
' E7 G$ Q2 r, ]1 q" p　　　　　　　　5 => '双子座',
1 U+ i3 w0 U7 M* ]( D4 Q　　　　　　　　6 => '巨蟹座',
　　　　　　　　7 => '狮子座',
　　　　　　　　8 => '座',
　　　　　　　　9 => '天秤座',
　　　　　　　　10 => '天蝎座',
" G- F+ [  }1 N: K5 P3 K　　　　　　　　11 => '射手座',
　　　　　　　　12 => '摩羯座'
2 D. t0 X8 O& x' w; p* U
! y7 T! s, F" }　　　　　生肖：0 => '',
. U; n+ o" K  O0 e; W) B　　　　　　　　1 => '鼠',
　　　　　　　　2 => '牛',
　　　　　　　　3 => '虎',
( |+ _+ I" f. O4 Y- y　　　　　　　　4 => '兔',
　　　　　　　　5 => '龙',
$ a4 g7 l  h3 G# i5 X　　　　　　　　6 => '蛇',
$ Q& c, T9 D) q. L# @, h　　　　　　　　7 => '马',
　　　　　　　　8 => '羊',
　　　　　　　　9 => '猴',
+ v: }4 n2 v0 J! {　　　　　　　　10 => '鸡',
　　　　　　　　11 => '狗',
6 C6 M7 D, _8 X% H2 V　　　　　　　　12 => '猪'

　　　　　性别：0 => '男',
; \- ?0 s+ X9 [; k: u& q　　　　　　　　1 => '女'

% T' M9 U0 F. ](5).增加好友
　　提交数据：VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号
5 u: e6 s4 q6 \5 E) ]
　　返回：VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=0&UN=对方QQ号(允许被加为好友，此时他已经是你的好友)
3 _6 P, |9 `2 |0 B　　　　　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号(决绝被加为好友)
　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、UN为字符)

(5).发送验证
　　说明：1、如果你加对方为好友，你需要发送验证
　　　　　2、对方加你为好友，发送了验证，你要通过或者拒绝
' u# p& i3 e1 P6 R8 `　　　　　这2种情况需要发送验证消息

　　提交数据：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号&CD=验证类型&RS=理由
7 I% J+ Y6 B9 {　　说明：CD为0表示“通过验证”，CD为1表示“拒决加为对方为好友”，CD为2表示“为请求对方加为好友”。

6 W, g3 L  ?# Y8 S, Q　　返回：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=0(成功)
" j2 |6 u3 C1 C  }. q/ U! Y　　　　　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字符)
: ]1 |" f* s4 x5 w& ^" J　　*如果服务器返回RES=3，那么这次对话的响应时间在20s。当发送验证请求的时候，必须连发2次(请求内容不必一样)，其中一条RES=3，对方收不到，一条RES=0，对方能够收到。当CD>=3时，RES=3，响应时间20s。

(6).删除好友
2 s5 T  F4 P4 Y) D　　提交数据：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&UN=删除的QQ号

- i+ o6 E1 l4 B　　返回：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(没有正确登陆)
; _; x8 Z' I1 K7 E! W　　　　　NULL(UIN、UN为字符)

(7).改变状态
/ ]5 q+ g: m' q6 i; A  ^8 j  n, W　　提交数据：VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&ST=状态代码
　　说明：状态代码：10为上线，20为离线，30为忙碌，40为隐身，其他视为非法
) b! r, k3 S# @$ \7 K4 J, e$ }
　　返回：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(没有正确登陆)
$ N0 R) _: s* H4 E; R2 y- n  p　　　　　NULL(UIN为字符，ST非法)

. s, M5 M- l* Y# e　　特别说明：如果你改变好友，将会给所有好友发送一条系统信息，内容就是状态代码；如果隐身，发送的状态代码为20，表示离线。
　　　　　　　同理，当你的好友改变状态，你也会收到一条系统信息。

(9).获得消息
5 p+ X9 s7 g2 ?0 \( i　　提交数据：VER=1.1&CMD=GetMsgEx&SEQ=标记&UIN=QQ号

　　返回：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的值用","分割，分别表示消息类型、发送人号码、消息内容)
  k* f4 R2 D6 v7 N* q　　　　　VER=1.1&CMD=GETMSGEX&SEQ=标记&UIN=QQ号&RES=0&MN=0&MT=&UN=&MG=(表示没有信息)
  N5 b" E& d* L0 o( I# f　　　　　VER=1.1&CMD=GETMSGEX&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN为字符)
　　说明：关于MT：
　　　　　　　9为用户消息，99为系统消息，2为请求信息，3为通过验证，4为拒绝被加好友
　　　　　关于MG：
　　　　　　　当MT=9时，MG为用户发送的消息内容
　　　　　　　当MT=99时,
　　　　　　　　　MG=10(QQ_STATUS_ONLINE)表示对方上线
1 e: D* s4 q1 I' n& ^! W* r　　　　　　　　　MG=20(QQ_STATUS_OFFLINE)表示对方下线
　　　　　　　　　MG=30(QQ_STATUS_BUSY)表示对方进入忙碌状态
　　　　　　　当MT=2时，MG为对方请求你验证的信息
% p) d- ]  {" u# f, O) k　　　　　　　当MT=3时，表示对方通过你的验证
　　　　　　　当MT=4时，MG为对方拒绝你理由
" h- N$ ~" j) _* R" h
/ O5 X" ~+ z8 P8 d3 q& f0 F(10).发送消息
　　提交数据：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&UN=对方QQ号&MG=发送内容

0 g6 C6 ]* H* w& I$ x　　返回：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=0&(成功发送，对方不一定能收到哦)
2 ?; b1 T# m: I4 f　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=3(发送过快)
& g; a( g) K# r7 o9 F, o　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、UN为字符，MG含非UTF-8字符)
　　说明：1、当你发消息时，以下情形对方可能看不到(其实是收到了，QQ不提示)你发送的消息：
- a2 @2 N2 w8 k- V- g  n' ]　　　　　　　你俩互为陌生人，且对方没有和你说过话
( J5 V, K+ K, r- Y) V1 K8 }　　　　　　　你在他的陌生人列表里，并且他没有和你说过话(没有验证)
　　　　　2、当你过快发送消息时，系统会给你一个惩罚，RES=3，相应时间20s
　　　　　3、当我发送含有小写字母h的信息时，服务器有可能返回NULL

(11).登出
$ ?7 W6 d& R$ U% O- ^　　提交数据：VER=1.1&CMD=Logout&SEQ=标记&UIN=QQ号

　　返回：VER=1.1&CMD=LOGOUT&SEQ=标记&UIN=QQ号&RES=0(成功，好像永远成功的，不管你是否登陆)
　　　　　NULL(UIN为字符)
# z' A1 B' B  ]4 ^
５、总结

　　通过对照以上的接口说明，我开发出了能够实现基本QQ功能的PHP类，它整合了以上所有的接口，使用更方便，可以开发QQ机器人、群发广告程序等。免费获得类的代码请到
/ p4 I6 s& h, S7 g　　http://blog.hackfan.net/index.ph ... d=a_20050819_223558
8 A: E6 z  O2 b" F7 c; {　　本文撰写时间仓促，难免有误，希望各位不吝赐教

# Z" B  d6 b4 A3 V8 y
; ~2 g( X5 {# j0 qTrackback: http://tb.donews.net/TrackBack.aspx?PostId=520301