QQ的HTTP接口探究

天云上人

作者：Hackfan
日期：2005.8.21凌晨
8 w5 y2 [* P/ R& Q联系：QQ:106814 Email:hackfan@vip.sina.com

; I2 W& V2 g( H2 C１、研究说明

) d2 v7 z/ ?' a8 `+ j4 n, N　　Tencent在tqq.tencent.com的8000有一个使用HTTP的QQ接口，通过这个接口，可以进行一些基本的操作，如：登陆、登出、改变登陆状态(上线、忙碌、离线、隐身)、添加删除好友、查看好友信息、发送验证信息(接受被加为好友、申请加对方为好友、拒绝被加为好友)、收发用户消息、系统信息。
& F6 {( L( r6 B* d
- J1 }5 L) S3 N( @　　目前我研究的是1.1版本的HTTP QQ协议，研究是微程在的成果上进行的，不敢说有什么超越，只不过更为详细和准确。

２、接口说明：
7 k( h5 N0 @% e- `4 ]! g! ~
　　接口位置：tqq.tencent.com:8000
　　通信协议：HTTP
　　数据传输方法：POST
- S% N! |$ q" o7 n　　HTTP请求格式：

$ \* U) a4 P; ]0 b5 uPOST HTTP/1.1
Host: tqq.tencent.com:8000
Content-Type: text/plain; charset=UTF-8
Content-length: 长度
Connection: close

数据

　　其中长度为 数据 的长度，数据的格式：
4 l4 ^, V! S, G- ?　　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还需要不同的参数，下面我就公布我的研究成果。
0 p; {$ v) M0 h" N
5 O2 [$ S+ _5 ?& Z* |; F8 f9 H& |- h$ h３、研究方法：

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

1. <?
   6 x1 o& G& r+ _5 _& l3 e; p
2. $uin = "QQ号";
   
3. $pwd = md5("QQ密码");
   
4. 
   5 u9 C# Z2 u$ r# a- i1 s8 H+ y$ M8 B
5. //登陆测试
   / ^! i$ Y* ^, i, G- d# Z" u
6. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=1&LC=9326B87B234E7235";
   
7. //注意：登陆测试不能同时进行，必须等到服务器认为QQ断开了，才能够测试，不然结果不可信
   & y3 F7 M, b3 h7 _5 {, e. q- z
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";
    ) p& z2 r- J) ^1 H, C
11. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=2&LC=9326B87B234E7235";
    9 U7 @$ r. q; y& C0 w
12. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=3&LC=9326B87B234E7235";
    - k' n) |$ W( X7 j5 {5 ^' @8 E! `
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";
    
15. *******/
    2 O/ p4 W" L2 e6 E. }' V' N
16. 
    
17. 
    
18. //得到好友列表
    8 [( N# [3 t  j* x+ M$ Y% k/ T5 c0 ~
19. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin;
    ! K# z: ]) |: j3 h; V
20. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0";
    * h. u% |% I( v" F. L
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);
    2 z7 f. N# c  I8 z0 F3 v
24. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=0";
    
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";
    1 _% K. ~6 J; X. B4 q5 ]
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";
    ) o" o( @' r$ B5 n5 d+ u7 n3 K& L7 A
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";
    9 E1 ~  {& o; u9 b
34. 
    , A0 \. b* D! t- ~
35. //得到在线列表
    
36. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin;
    7 S, U4 v6 l6 d3 I5 [
37. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0";
    + C$ ]! p% G( B
38. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160";
    . w' u! [- }. u# A( Z& a3 h
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);
    5 ?4 F4 @$ g" e3 U* E1 V! c9 y" ^
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";
    4 I0 g. W  |1 Q' Y/ s) x0 ?1 ]* U
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";
    
45. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    " ~* l# d! l8 {9 ?+ A
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);
    9 n/ r5 l: D8 S; u0 s- Y# \
48. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    8 l/ f! K8 H' v$ c. @, M0 x1 S
49. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    . u+ O5 D, |0 s5 m. X2 v
50. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=106814";
    
51. 
    5 @2 L9 R5 c* ^2 h
52. //查看好友信息
    
53. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=0&UN=106814";
    $ G  Y& N; U( d9 \4 ^  q7 {$ g) Z, R
54. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=1&UN=106814";
    2 u8 O  I. }5 g: K2 W" w' p& P9 p$ n
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";
    % s7 J" f/ ~& T, S! T; q
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";
    
59. 
    ! o5 W, W/ o. a
60. //增加好友
    
61. $poststring[] = "VER=1.1&CMD=AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    
62. 
    1 g  ?; U+ H$ V6 a
63. //发送验证
    6 N, [# ~; f* W% o' r) u; n9 S
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";
    ; b9 k) P6 U& G5 W% U" d! U4 Q
67. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=3&RS=TEST";
    0 W  J  |5 t9 j8 O1 Q0 T$ Q
68. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=4&RS=TEST";
    # P' M. k/ Z8 j- |% r# n
69. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=5&RS=TEST";
    ' |1 K+ S1 t+ F/ B
70. 
    
71. //删除好友
    7 Y0 v1 Q# O* F8 ~& R& r0 T
72. $poststring[] = "VER=1.1&CMD=DelFromList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    * O! W6 x6 l; p# w
73. 
    
74. //改变状态
    
75. for($i=0;$i<=60;$i=$i+5)
    * v. `0 G% s/ B0 g- E- W
76. {
    0 m1 _0 D! }9 X0 q. |, f. a1 C4 o
77. $poststring[] = "VER=1.1&CMD=Change_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&ST=".$i;
    
78. }
    3 ?% s! q" s+ @( c, m2 h7 B* E
79. 
    4 H* S, r0 q' h# ^0 J' R
80. //获得消息
      a" A) K1 B/ Z
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. 
    . H, A, ?  m! t9 J; ^( `
86. //登出
    ) _% U! ~# A4 u: z: e  m: W
87. $poststring[] = "VER=1.1&CMD=Logout&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    # c0 M) _2 \/ }! E9 }
88. 
    
89. $file = fopen("p.txt","w");
    : W' o% B( i  n6 }) k6 s
90. 
    
91. foreach($poststring as $k=>$v)
    
92. {
    , r% F+ {  {$ w. m' {7 M) m! _
93. ss_timing_start();
    ! p( T! @! f1 a# w& A
94. $fp = fsockopen('tqq.tencent.com', '8000', $errno, $errstr, $timeout = 10);  
    5 F$ e. z& l; m0 r
95. 
    
96. if(!$fp){  
    
97. //error tell us  
    * @+ ~$ ?: Y  p, f& x4 Z* M) _# P/ S
98. $content = $k.chr(13).chr(10)."ERROR:$errstr ($errno)";  
    : V9 ?/ m% z" C
99.    
    
100. }else{  
     3 D1 O- k& J: @8 K, l- C" ^
101. 
     
102.   //send the server request  
     
103.   fputs($fp, "POST HTTP/1.1\r\n");  
     " D- y2 ?& ]+ Z) a
104. //  fputs($fp, "Host: $host\r\n");  
     ; I! y, m/ u. W- E# K
105. //  fputs($fp, "Content-type: application/x-www-form-urlencoded\r\n");  
     ; j0 c7 l0 j( w2 ?. y; i
106.   fputs($fp, "Content-length: ".strlen($v)."\r\n");  
     * p; J' l2 u+ ]+ o
107.   fputs($fp, "Connection: close\r\n\r\n");  
     / l- B( e' c0 E/ k1 x. \
108.   fputs($fp, $v . "\r\n\r\n");  
     
109. 
     ) J; ]4 h0 x% N: `$ [
110.   //loop through the response from the server  
     
111.   $res = "";
     
112.   while(!feof($fp)) {  
     
113.   $res .= fgets($fp, 4096);  
     / z* f# n* p/ f- e/ b3 R
114.   }  
     1 F4 `% U$ M1 t! ~+ j
115.   //close fp - we are done with it  
     1 d% O- j# R  W5 X' y- P
116.   fclose($fp);  
     
117. 
     
118.   $content = $v.chr(13).chr(10).$res;
     # O8 F: u& u6 d8 K1 ^
119. }  
     
120. ss_timing_stop();  
     - e( A( }8 ?: \: T
121. $content .= chr(13).chr(10)."Time: ".ss_timing_current().chr(13).chr(10)."--------------------------------------".chr(13).chr(10);
     8 N1 b; i! Y$ Y
122. fputs($file,$content);
     
123. }
     . L: t4 B7 Y/ q8 Q8 ~
124. fclose($file);
     
125. ?>
     
126. <?
     3 H& q, ?6 ]& g3 c$ }% s9 C
127. function ss_timing_start ($name = "default") {  
     
128. global $ss_timing_start_times;  
     
129. $ss_timing_start_times[$name] = explode(' ', microtime());  
     4 \; B- O3 U! w/ |. _" j1 @3 k
130. }  
     9 d' v9 U, ?) J/ w. S
131. function ss_timing_stop ($name = "default") {  
     
132. global $ss_timing_stop_times;  
     # V! g$ J+ T) t6 [* n. F
133. $ss_timing_stop_times[$name] = explode(' ', microtime());  
     6 T+ D7 y; A+ S5 v* e; P5 X" j' T
134. }  
     
135. function ss_timing_current ($name = "default") {  
     
136. global $ss_timing_start_times, $ss_timing_stop_times;  
     
137. if (!isset($ss_timing_start_times[$name])) {  
     
138. return 0;  
     . X' R: }" ~7 P" {) V; l1 k
139. }  
     
140. if (!isset($ss_timing_stop_times[$name])) {  
     6 s9 l6 R+ Q% l* `5 w0 q; q
141. $stop_time = explode(' ', microtime());  
       e0 s. r4 E% e) p6 f6 ]
142. }  
     
143. else {  
     4 M3 e+ j- b* H( \( {% d
144. $stop_time = $ss_timing_stop_times[$name];  
     
145. }  
     
146. $current  =  $stop_time[1]-$ss_timing_start_times[$name][1];  
     0 F9 \" @5 y$ P
147. $current += $stop_time[0]-$ss_timing_start_times[$name][0];  
     - z  A5 @2 y5 b3 Y
148. return $current;  
     
149. }  
     ) {$ ?; ^. f; |& @
150. ?>

复制代码

４、研究成果：

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

! n& i, f, U7 h) ?, K% [; d　　提交数据：VER=1.1&CMD=Login&SEQ=标记&UIN=QQ号&PS=QQ密码&M5=1&LC=9326B87B234E7235
　　说明：QQ密码是通过md5加密的字符串，在PHP中可以直接用md5()进行加密；
* X3 B# g/ H9 g; \　　　　　M5这个参数的作用还不清楚，但最好为1。
　　　　　LC这个参数有点神秘，不能有丝毫改动，不然服务器就没有响应(没有响应就是返回NULL)。
! @% f! f* H- P) `7 ]8 f7 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)
( m% T1 v3 {4 ?　　　　　NULL(UIN为字符、PS为空、LC错误)
  G; D8 ]+ v3 m2 {9 A; l
(2).得到好友列表
　　提交数据：VER=1.1&CMD=List&SEQ=标记&UIN=QQ号&TN=160&UN=0
$ b. |" E8 @$ F/ Y　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响
6 F+ R( \: k: T! M# g
　　返回：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为好友列表，用","分割)
5 P& W$ t) t4 P* m5 t　　　　　VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
8 r1 S* d. y9 z, K' ~( U& |　　　　　NULL(UIN、TN、UN为字符)

(3).得到在线好友列表
, K" e3 t9 g* m　　提交数据：VER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号&TN=50&UN=0
　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响
4 y4 p& c. U- q4 L
9 b" R9 b: ]8 m9 S　　返回：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$ |+ q4 h# u　　　　　NULL(UIN、TN、UN为字符)
- J( B! P, {' `: w$ `+ P, l　　说明：FC为QQ头像的的ID，如的头像ID为270，那么其头使用的图片为91.bmp,其算法为ID/3+1；
　　　　　ST为QQ用户的状态，10为上线，20为离线(或隐身)，30为忙碌；
5 \% P6 \3 n4 a/ Q5 A% k
　　特别说明：当参数TN=0或不存在时，服务器返回：
, _1 w  ^5 ?/ C8 ?$ ZVER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号
* m* r- Z& o6 C& qHTTP/1.1 200 OK
2 m! {0 Y  ]$ i% sServer: tencent imserver/1.0.0
* \1 \- g  Y: s" ]Content-Type: text/plain; charset=UTF-8
Content-Length: 56
( y8 a7 s" x1 I; V( d0 b
VER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FN=1
. H2 ^" _7 z, `5 WHTTP/1.1 200 OK
) b# G8 l  f" ?/ f2 d' }* YServer: tencent imserver/1.0.0
) T' h( }5 L$ z; [Content-Type: text/plain; charset=UTF-8
Content-Length: 77
$ W( `7 L2 G+ }- G
' ]  i) d* C& N0 j3 eVER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FC=&FN=1&SN=0&ST=&UN=&NK=
　　返回了２次，第一次的结果中，FN为在线好友数，第二次返回的数据基本没用。
/ Y: O/ J- n0 z. l
(4).查看好友信息
5 R% c0 d2 D4 b6 `3 j* {" |3 L　　提交数据：VER=1.1&CMD=GetInfo&SEQ=标记&UIN=QQ号&LV=查询类型&UN=被查询QQ号码
　　说明：LV=0,1为精简查询，LV=2为普通查询，LV>=3为详细查询

7 }# i5 [; v5 y8 A, X5 N2 g　　返回：VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=0&LV=0&UN=106814&NK=Hackfan 好(精简查询)
% p# c! N+ o- i　　　　　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=学生
# i( S% u% h  w2 h3 c/ Z' H&LV=2&PC=邮编&PH=电话&PR= The guy is updating to .NET Frameword......&PV=江苏&RN=胡吉阳&SC= 毕业院校&SX=0&UN=106814&NK=Hackfan  
: D: n4 C# W9 M- _; F* p4 P好(普通查询)
　　　　　VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=0&AD =地址&AG=19&BT=2&CO=6&CT=苏州&CV=%01&CY=中华人民共和国
  V8 [0 @, d" N7 J1 c&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  
+ V9 d2 }3 D- Q8 c, a  a( Xupdating to .NET Frameword......&PV=江苏&RN=胡吉阳&SC=毕业院校&SH=3&SX=0&UN=106814&NK=Hackfan 好(详细查询)
) S6 `1 T; B1 S; F1 y; A4 R　　　　　VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、LV、UN为字符)
! i- F6 t8 {2 ~0 E9 ^
　　说明：AD为联系地址
　　　　　AG为年龄
' l$ o( Z$ T  ^3 ?  y2 S- @　　　　　BT为血型
) h6 {7 P9 [, K4 s5 z　　　　　CO为星座
. u7 |" I+ O8 V, l& ]8 O　　　　　CT为城市
　　　　　CV为未知*
3 i' f- |& m  R" Q' d- h　　　　　CY为国家
- s# C! P5 L' R　　　　　EM为Email
1 k) t) A& C+ o4 }1 I+ k　　　　　FC为头像
; Q+ u5 i( [+ f: Z  A　　　　　HP为网站
　　　　　ID为未知
3 P3 S7 t5 N5 c: p' S& C　　　　　JB为职业
　　　　　LV为查询代码(就是发送的LV)
0 a, o  A) p( n8 g: u' J　　　　　MO为移动电话
- [- Q) v4 P" |　　　　　MT为未知
　　　　　MV为未知
　　　　　PC为邮编
4 B: Q1 S8 ^# \　　　　　PH为联系电话
( O7 Q: w$ {2 Z$ O) D& a% I　　　　　PR为简介
　　　　　PV为省
) M  m8 f% [& _. }" j- o% I- n　　　　　RN为真实姓名
  Q' t# k/ z* |0 E- ]　　　　　SC为毕业院校
　　　　　SH为生肖
5 V* U" F/ V3 Y1 y) {; T/ I- p! o8 L　　　　　SX为性别
! g! \, O( B- @: ]　　　　　UN为QQ号
　　　　　NK为昵称
- A' U/ }* h% V4 r; K
　　　　　血型：0 => '',
# l$ ?0 }4 a4 n; _, ]" Y2 Z: [/ l- M　　　　　　　　1 => 'A型',
　　　　　　　　2 => 'B型',
　　　　　　　　3 => 'O型',
5 M! P. f( ^; t& ]　　　　　　　　4 => 'AB型',
　　　　　　　　5 => '其他'


, V- N: M1 @- W7 m4 _　　　　　星座：0 => '',
$ f1 v, ^& N  y　　　　　　　　1 => '水瓶座',
　　　　　　　　2 => '双鱼座',
　　　　　　　　3 => '牡羊座',
　　　　　　　　4 => '金牛座',
　　　　　　　　5 => '双子座',
6 H% \1 X& v4 y. V: U　　　　　　　　6 => '巨蟹座',
　　　　　　　　7 => '狮子座',
　　　　　　　　8 => '座',
0 `  v; M, u: y　　　　　　　　9 => '天秤座',
　　　　　　　　10 => '天蝎座',
, \, ?3 D6 y8 H* w　　　　　　　　11 => '射手座',
　　　　　　　　12 => '摩羯座'
; T  w% p; W0 t( Y+ X  z
　　　　　生肖：0 => '',
　　　　　　　　1 => '鼠',
, D. S- N, p7 r' C& ]　　　　　　　　2 => '牛',
: u8 G2 I9 i+ v/ {: Y+ `　　　　　　　　3 => '虎',
　　　　　　　　4 => '兔',
　　　　　　　　5 => '龙',
　　　　　　　　6 => '蛇',
% B' i8 [. ]+ P　　　　　　　　7 => '马',
　　　　　　　　8 => '羊',
" O  |( V6 I/ O1 `: O/ c& H　　　　　　　　9 => '猴',
　　　　　　　　10 => '鸡',
( r  ]3 [' H$ Q. ~　　　　　　　　11 => '狗',
　　　　　　　　12 => '猪'

　　　　　性别：0 => '男',
　　　　　　　　1 => '女'

  T/ L$ o/ O% K0 ]. b* \(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号(允许被加为好友，此时他已经是你的好友)
　　　　　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(没有正确登陆)
; f( A# [6 x% `( a' n　　　　　NULL(UIN、UN为字符)

(5).发送验证
4 V% f& _; k* k& T9 i, H( d9 J5 C　　说明：1、如果你加对方为好友，你需要发送验证
　　　　　2、对方加你为好友，发送了验证，你要通过或者拒绝
! ]2 U0 E1 X1 m/ d! d$ x7 r' j　　　　　这2种情况需要发送验证消息

8 P- n+ a% [! J& \; D　　提交数据：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号&CD=验证类型&RS=理由
, t; N! _: V3 E　　说明：CD为0表示“通过验证”，CD为1表示“拒决加为对方为好友”，CD为2表示“为请求对方加为好友”。
6 X3 z& B1 Z- O( H$ O/ X1 P- }
2 T& w3 P; z2 J, k& K5 Y! A　　返回：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=0(成功)
　　　　　VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=3(*)
/ H" L. q3 V+ O" e! J* G　　　　　VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、UN、CD为字符，RS为非UTF-8字符)
- r$ W2 d, j- O2 d9 }* C　　*如果服务器返回RES=3，那么这次对话的响应时间在20s。当发送验证请求的时候，必须连发2次(请求内容不必一样)，其中一条RES=3，对方收不到，一条RES=0，对方能够收到。当CD>=3时，RES=3，响应时间20s。

' u' b9 N% s% }; G, z8 t(6).删除好友
3 O$ T4 j# |! w3 b5 C* Q, _" y　　提交数据：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&UN=删除的QQ号
0 r9 j/ V4 ^2 e: L
) M! q+ o( k9 o: W* h　　返回：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=0&(成功)
) R9 {$ l0 m7 f　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=3(响应时间30s，重复发送的后果)
4 b# F  G5 F( `; W　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
" [% I) S8 H- i　　　　　NULL(UIN、UN为字符)

(7).改变状态
　　提交数据：VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&ST=状态代码
) J% u& t5 q  E) M! J　　说明：状态代码：10为上线，20为离线，30为忙碌，40为隐身，其他视为非法
4 D( z/ r$ T+ ?0 v% v" p" P7 L
" Y0 x8 n4 ?+ E% Q5 A( o; b　　返回：VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=0&(成功)
　　　　　VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=3(失败，原因不明，响应时间20s，可能是过于频繁的改变状态引起的)
# f: t4 b/ h! \  I　　　　　VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
7 L# `" D7 n" T0 s　　　　　NULL(UIN为字符，ST非法)
' K, D1 _8 Z* v9 [7 a5 u/ g+ l
　　特别说明：如果你改变好友，将会给所有好友发送一条系统信息，内容就是状态代码；如果隐身，发送的状态代码为20，表示离线。
4 l5 v/ y1 L, D4 S( R8 Z　　　　　　　同理，当你的好友改变状态，你也会收到一条系统信息。

: I( Z* z$ H0 t4 L(9).获得消息
　　提交数据：VER=1.1&CMD=GetMsgEx&SEQ=标记&UIN=QQ号

  C' Y- m3 v$ ~. }: J/ 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的值用","分割，分别表示消息类型、发送人号码、消息内容)
　　　　　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(没有正确登陆)
　　　　　NULL(UIN为字符)
- n+ h2 e; @* X) n7 k9 O　　说明：关于MT：
6 s$ @9 M* T/ z: a' F　　　　　　　9为用户消息，99为系统消息，2为请求信息，3为通过验证，4为拒绝被加好友
% L: O1 i, H% d% f8 M& M* E6 r　　　　　关于MG：
5 r( ^, Q+ U3 b( A9 _　　　　　　　当MT=9时，MG为用户发送的消息内容
( J0 p" n* N- \  ]3 b5 @/ A: C, H5 d　　　　　　　当MT=99时,
　　　　　　　　　MG=10(QQ_STATUS_ONLINE)表示对方上线
% g4 o* Q1 J: F' V% T) {　　　　　　　　　MG=20(QQ_STATUS_OFFLINE)表示对方下线
" Z# I% M+ O$ Z0 K: J7 C　　　　　　　　　MG=30(QQ_STATUS_BUSY)表示对方进入忙碌状态
　　　　　　　当MT=2时，MG为对方请求你验证的信息
　　　　　　　当MT=3时，表示对方通过你的验证
　　　　　　　当MT=4时，MG为对方拒绝你理由

(10).发送消息
- |1 m6 W7 `; N' z. o. v( y　　提交数据：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&UN=对方QQ号&MG=发送内容

　　返回：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=0&(成功发送，对方不一定能收到哦)
　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=3(发送过快)
1 D  L- w! G/ ~! T; |　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
, ^1 J/ G1 y9 v" |+ Z. x　　　　　NULL(UIN、UN为字符，MG含非UTF-8字符)
　　说明：1、当你发消息时，以下情形对方可能看不到(其实是收到了，QQ不提示)你发送的消息：
　　　　　　　你俩互为陌生人，且对方没有和你说过话
( l7 Y* o8 a( R- B7 J) U　　　　　　　你在他的陌生人列表里，并且他没有和你说过话(没有验证)
" o& Y# `4 d  Q: y2 ^# m# ?7 r　　　　　2、当你过快发送消息时，系统会给你一个惩罚，RES=3，相应时间20s
　　　　　3、当我发送含有小写字母h的信息时，服务器有可能返回NULL

5 H% D5 _* l" L/ l- K(11).登出
% ~2 Q* @+ r5 S8 [# U/ [　　提交数据：VER=1.1&CMD=Logout&SEQ=标记&UIN=QQ号

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

" v4 e1 ?; m8 T$ [/ M- J4 P8 N3 o５、总结
8 l( y3 o& _/ s; P8 Y# e9 `+ o* }
　　通过对照以上的接口说明，我开发出了能够实现基本QQ功能的PHP类，它整合了以上所有的接口，使用更方便，可以开发QQ机器人、群发广告程序等。免费获得类的代码请到
　　http://blog.hackfan.net/index.ph ... d=a_20050819_223558
4 K, ~9 u4 X. c　　本文撰写时间仓促，难免有误，希望各位不吝赐教
/ t/ T% R& f8 G# V0 p: \
& S: f3 C& B$ u, r7 {0 Z3 w3 k
Trackback: http://tb.donews.net/TrackBack.aspx?PostId=520301