QQ的HTTP接口探究

天云上人

作者：Hackfan
) f" h; ~4 N! C. x. N2 ?+ {日期：2005.8.21凌晨
; ^: y( p  k/ w9 f4 W% H7 c9 a2 g联系：QQ:106814 Email:hackfan@vip.sina.com

１、研究说明
9 ^& v0 r& }1 j$ i. K9 L+ I
　　Tencent在tqq.tencent.com的8000有一个使用HTTP的QQ接口，通过这个接口，可以进行一些基本的操作，如：登陆、登出、改变登陆状态(上线、忙碌、离线、隐身)、添加删除好友、查看好友信息、发送验证信息(接受被加为好友、申请加对方为好友、拒绝被加为好友)、收发用户消息、系统信息。

6 S- Y) ?* r% o　　目前我研究的是1.1版本的HTTP QQ协议，研究是微程在的成果上进行的，不敢说有什么超越，只不过更为详细和准确。
9 |8 X& ]# K, {2 V5 M0 n
' O! |5 M& r8 ?' K# k２、接口说明：
" s, `) ~$ ?. s% r0 _  C% W: \
+ b1 b  K$ V6 C4 d0 s% m/ o　　接口位置：tqq.tencent.com:8000
  p3 g, U' U) c( ?9 S# ^　　通信协议：HTTP
. B4 w, u5 ~6 H　　数据传输方法：POST
　　HTTP请求格式：

POST HTTP/1.1
) a' C' E4 O  L. _" a* Q/ J: Z) yHost: tqq.tencent.com:8000
Content-Type: text/plain; charset=UTF-8
* c# S: a* E! V5 g. fContent-length: 长度
. U1 R+ u6 o. k  @$ Z1 ]) C+ e, ~Connection: close

数据

9 M: _0 Q$ F+ V/ O8 F　　其中长度为 数据 的长度，数据的格式：
　　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还需要不同的参数，下面我就公布我的研究成果。

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

1. <?
   " u8 H: o9 D7 A5 P9 ^; |
2. $uin = "QQ号";
   . p6 P2 O* W$ s" t! d
3. $pwd = md5("QQ密码");
   ) O4 @" D: ~7 }3 i( G% z1 U
4. 
   . t0 V  i" [+ ?8 `4 _. W3 C
5. //登陆测试
   ' V' N- V5 v8 {5 H0 `2 L8 |
6. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=1&LC=9326B87B234E7235";
   
7. //注意：登陆测试不能同时进行，必须等到服务器认为QQ断开了，才能够测试，不然结果不可信
   ! W3 I5 D9 s1 }) X& |+ j0 \
8. /*******
   
9. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=0&LC=9326B87B234E7235";
   . }# ?8 e/ w* i6 h) F
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";
    1 Y7 j6 j; h5 |3 I' @
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";
    $ g( D0 N  i2 E5 `* V) S7 _' q
15. *******/
    ; O  U: {7 F, o$ u
16. 
    ( ^! l3 H$ R, a9 _7 n
17. 
    
18. //得到好友列表
    
19. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin;
    4 n7 _+ w* o. S: }0 i1 L- E* Y, w
20. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0";
    1 t6 U; S- W) S: u
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);
    
24. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=0";
    4 X! E7 X! _2 {" g2 K9 S$ _
25. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    " B0 c3 \# V; X& Y& E- L
26. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    $ q) i. A  y9 j5 g
27. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    " S6 J5 o0 D) i1 L: i" z
28. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    * [) `2 c- b' R; U; _0 f
29. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    9 y" H- J1 Y& a% T) A* e, x' W% ^
30. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    ; p& U6 `9 Q+ U# B5 |
31. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    : @# n& q+ e" k/ l
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. 
    
35. //得到在线列表
    
36. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin;
    , e4 ]! B2 ?- C  K* C
37. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0";
    . ?0 k. A# d4 k# n7 ?
38. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160";
    " g/ x+ K6 @' ?( m+ R
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);
    + m" G& H, p" ]% a5 J
41. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=0";
    - G" M2 m2 @# L- x) Y
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";
      ?2 }+ N7 N+ c6 f
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";
    
46. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    ) Q! ?# E  X7 b5 k, j
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);
    
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";
    " P( x( C1 M1 Z+ w
51. 
    * s) P8 B+ n. H8 G- P; Y2 }
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";
    
55. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=2&UN=106814";
      Z; V7 b2 n% z+ d3 G1 M  G
56. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=3&UN=106814";
    4 X- t" ~/ p1 o1 Q( Q% W+ Z1 W) _
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. 
    
60. //增加好友
    
61. $poststring[] = "VER=1.1&CMD=AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    ' d  W! V* ^, ]3 m4 q" R8 M  W8 ^* \
62. 
    ) n+ r- ]+ N% q' V+ Y
63. //发送验证
    # v) l3 o, Q1 o, W' I
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";
    : B5 ]" O, n9 M% V
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";
    % k: l& [  M& `& e. w
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";
    1 ?- x1 g2 ~' s  p" K
70. 
    5 ~& G4 h2 V! g; b7 T
71. //删除好友
    
72. $poststring[] = "VER=1.1&CMD=DelFromList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    & I: W% q5 N4 W3 t4 w
73. 
    7 u' Y$ z0 B2 e7 P! n( Q
74. //改变状态
    3 w' A* w) M/ I
75. for($i=0;$i<=60;$i=$i+5)
    * P$ {/ @3 i8 s7 g1 S( D
76. {
    # B6 W- i9 O' P' P7 `/ R
77. $poststring[] = "VER=1.1&CMD=Change_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&ST=".$i;
    
78. }
    3 K+ ]" a0 k; q5 n: ^# B' t1 g
79. 
    ! E  d9 Z/ j8 B& K- |" u& n
80. //获得消息
    4 v' F5 F9 I6 }0 ?- j) Q. S$ w  O
81. $poststring[] = "VER=1.1&CMD=GetMsgEx&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    
82. 
    1 K. f% m; i! A# Y
83. //发送消息
    
84. $poststring[] = "VER=1.1&CMD=CLTMSG&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&MG=TEST";
    ( h! V$ O7 K" E" h% [& v
85. 
    9 Z' I" H- U& ~; X2 p9 ?
86. //登出
    # g" M5 D( i, p- I' P* G1 {2 L
87. $poststring[] = "VER=1.1&CMD=Logout&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    
88. 
    , X. A( Y5 q$ [6 s' B7 ]- j
89. $file = fopen("p.txt","w");
    % p9 ~+ B. A5 B" c
90. 
    
91. foreach($poststring as $k=>$v)
    / X; A! g- {3 a! H/ B" _
92. {
    $ I/ N, r6 N2 l1 |' z
93. ss_timing_start();
    
94. $fp = fsockopen('tqq.tencent.com', '8000', $errno, $errstr, $timeout = 10);  
    
95. 
    0 ~9 ]5 P* [2 r2 d4 Q4 X0 o
96. if(!$fp){  
    8 h7 g1 _. w2 W" T5 s
97. //error tell us  
    
98. $content = $k.chr(13).chr(10)."ERROR:$errstr ($errno)";  
    
99.    
    
100. }else{  
     
101. 
     
102.   //send the server request  
     5 L" A  _+ _! k, i8 l
103.   fputs($fp, "POST HTTP/1.1\r\n");  
     9 u  Y. V2 e# P$ H  x. g  H) s' F
104. //  fputs($fp, "Host: $host\r\n");  
     
105. //  fputs($fp, "Content-type: application/x-www-form-urlencoded\r\n");  
     
106.   fputs($fp, "Content-length: ".strlen($v)."\r\n");  
     " i) q: B$ r' _5 C8 h& `: @
107.   fputs($fp, "Connection: close\r\n\r\n");  
     
108.   fputs($fp, $v . "\r\n\r\n");  
     
109. 
     
110.   //loop through the response from the server  
     + W9 Z* n" [! B1 R4 v, r. E4 S
111.   $res = "";
     
112.   while(!feof($fp)) {  
     + S3 o. H2 X- k: e) k
113.   $res .= fgets($fp, 4096);  
     
114.   }  
     
115.   //close fp - we are done with it  
     
116.   fclose($fp);  
     ! Q+ U5 Q% |3 J1 N, v/ g
117. 
     
118.   $content = $v.chr(13).chr(10).$res;
     
119. }  
     
120. ss_timing_stop();  
     
121. $content .= chr(13).chr(10)."Time: ".ss_timing_current().chr(13).chr(10)."--------------------------------------".chr(13).chr(10);
     7 b% f' p7 X/ K% L
122. fputs($file,$content);
     
123. }
     6 ^, d+ ?8 t- p  |6 M7 U: V) N1 X
124. fclose($file);
     
125. ?>
     
126. <?
     
127. function ss_timing_start ($name = "default") {  
     
128. global $ss_timing_start_times;  
     " }  M4 g+ ^4 O. V3 O. Q
129. $ss_timing_start_times[$name] = explode(' ', microtime());  
     
130. }  
     
131. function ss_timing_stop ($name = "default") {  
     1 G1 i  {! [1 Z; G: g# {
132. global $ss_timing_stop_times;  
     
133. $ss_timing_stop_times[$name] = explode(' ', microtime());  
     5 _9 c/ n, m0 \" _" Q1 d3 ^
134. }  
     ; a4 f+ e- u/ R# d
135. function ss_timing_current ($name = "default") {  
     
136. global $ss_timing_start_times, $ss_timing_stop_times;  
     ' u0 x. F+ t9 c9 d
137. if (!isset($ss_timing_start_times[$name])) {  
     . u7 A: q" y% `8 M& u
138. return 0;  
     4 k  P/ c: Z* u
139. }  
     8 B4 c2 `3 m, K9 X
140. if (!isset($ss_timing_stop_times[$name])) {  
     
141. $stop_time = explode(' ', microtime());  
     ! B8 j6 o1 b' _- |
142. }  
     
143. else {  
     
144. $stop_time = $ss_timing_stop_times[$name];  
     2 L  B2 }2 X. C% D7 I
145. }  
     ; k# Q# Z4 I& ]: n; p
146. $current  =  $stop_time[1]-$ss_timing_start_times[$name][1];  
     
147. $current += $stop_time[0]-$ss_timing_start_times[$name][0];  
     $ [& w, B7 P# w& `
148. return $current;  
     8 O9 N2 B# r, K; ]% w
149. }  
     
150. ?>

复制代码

４、研究成果：
) n5 S& ^/ T+ f* B$ c
% r& m3 n3 v/ f- V1 J(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
. J" R4 F, m4 M$ s! @　　说明：QQ密码是通过md5加密的字符串，在PHP中可以直接用md5()进行加密；
　　　　　M5这个参数的作用还不清楚，但最好为1。
　　　　　LC这个参数有点神秘，不能有丝毫改动，不然服务器就没有响应(没有响应就是返回NULL)。

　　返回：VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=0&RS=0&HI=60&LI=300(成功)
# e. g1 k0 {# p6 p  d  Z; S　　　　　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)
2 M/ D. M8 z% Q1 n" @8 Q, M( @　　　　　NULL(UIN为字符、PS为空、LC错误)

(2).得到好友列表
+ ]: q; i1 R) a0 J* Z( Z* v　　提交数据：VER=1.1&CMD=List&SEQ=标记&UIN=QQ号&TN=160&UN=0
　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响
0 b' ]( N& L& U9 w  z. p3 k
　　返回：VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=0&FN=9(当TN=0或没有TN参数时，FN表示好友数)
9 `& ~, X& w9 p' y　　　　　VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=0&FN= 1&SN=9&UN=3814526,...,(当TN存在且非0时，FN=1，SN表示好友数，UN为好友列表，用","分割)
. a" r. G! m2 }$ g. x7 {5 {　　　　　VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
! X5 U$ M9 _' ]# L/ K　　　　　NULL(UIN、TN、UN为字符)
# n' q! q& k: v
5 V4 q" r. s8 n5 P$ I( ]- I4 {9 U(3).得到在线好友列表
　　提交数据：VER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号&TN=50&UN=0
, r5 T% h2 ], t0 V) r, J　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响

  `3 v& w# }, |- W/ x( g　　返回：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(没有正确登陆)
4 D: i  d/ d0 O' d# k+ q( Y" }　　　　　NULL(UIN、TN、UN为字符)
　　说明：FC为QQ头像的的ID，如的头像ID为270，那么其头使用的图片为91.bmp,其算法为ID/3+1；
　　　　　ST为QQ用户的状态，10为上线，20为离线(或隐身)，30为忙碌；
1 K' `  }. k+ m
　　特别说明：当参数TN=0或不存在时，服务器返回：
$ ]  R% X5 V* xVER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号
HTTP/1.1 200 OK
: N1 M, H, H6 }  d4 k  y3 \Server: tencent imserver/1.0.0
Content-Type: text/plain; charset=UTF-8
4 H. e+ _$ w4 J. W4 u% DContent-Length: 56

, X9 ]) ?; a5 e2 qVER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FN=1
HTTP/1.1 200 OK
* o" f" N, H% G7 A1 A# B' k* ~Server: tencent imserver/1.0.0
! [0 m( i. T0 M. v  GContent-Type: text/plain; charset=UTF-8
Content-Length: 77
4 e# |4 {4 E. t. \- Y) w9 k
& m+ O3 l% D! t7 a$ K( ?* c# XVER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FC=&FN=1&SN=0&ST=&UN=&NK=
　　返回了２次，第一次的结果中，FN为在线好友数，第二次返回的数据基本没用。
1 ?1 w: t8 ~7 R* n) f" }
& }* v$ z2 I! |) Z. x1 V7 E(4).查看好友信息
　　提交数据：VER=1.1&CMD=GetInfo&SEQ=标记&UIN=QQ号&LV=查询类型&UN=被查询QQ号码
2 G4 C" k1 Z2 {  f$ |# G　　说明：LV=0,1为精简查询，LV=2为普通查询，LV>=3为详细查询
$ _- y1 m% v' B
/ j* b) }& t0 W: T　　返回：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  
& s$ K- t4 q% a2 c3 n好(普通查询)
( P$ l+ P; Y* E3 q* j. v　　　　　VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=0&AD =地址&AG=19&BT=2&CO=6&CT=苏州&CV=%01&CY=中华人民共和国
" u% f6 m9 i( B2 A/ X: L4 f&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  
* U% ~; M" s2 Yupdating 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为字符)
4 `8 O! D, g/ f! W
* T0 w1 B! B* R　　说明：AD为联系地址
) q' H8 ?; H' V1 a# F　　　　　AG为年龄
7 f% A; u2 ?. q- g/ g　　　　　BT为血型
# H- Y. w  [, J) n　　　　　CO为星座
　　　　　CT为城市
　　　　　CV为未知*
　　　　　CY为国家
　　　　　EM为Email
# b1 q3 l& B* q- g　　　　　FC为头像
　　　　　HP为网站
　　　　　ID为未知
　　　　　JB为职业
5 {; T, U0 d+ b* b# n　　　　　LV为查询代码(就是发送的LV)
, c  k. D8 q' s  |0 Z; {/ t. z　　　　　MO为移动电话
/ v2 T2 B+ x7 m* Y# `6 W1 r　　　　　MT为未知
　　　　　MV为未知
' c' s% `' S) |2 J- {* V8 X　　　　　PC为邮编
7 x$ m! J* Y2 `: [　　　　　PH为联系电话
　　　　　PR为简介
  P2 h. C  M( `9 C9 S) H! K　　　　　PV为省
　　　　　RN为真实姓名
　　　　　SC为毕业院校
　　　　　SH为生肖
　　　　　SX为性别
　　　　　UN为QQ号
: E% |$ H7 v3 K& u* I( m- y　　　　　NK为昵称

1 X9 C( L' \+ _8 \4 B7 g　　　　　血型：0 => '',
　　　　　　　　1 => 'A型',
　　　　　　　　2 => 'B型',
　　　　　　　　3 => 'O型',
* t# ]5 n8 z4 w　　　　　　　　4 => 'AB型',
; {. C6 |/ }$ D7 d7 }" }　　　　　　　　5 => '其他'
# D: N1 L0 L8 N

　　　　　星座：0 => '',
. K2 L0 u4 w* L5 ]' N4 y, N　　　　　　　　1 => '水瓶座',
1 X8 A+ w* z% _2 C: y" ~　　　　　　　　2 => '双鱼座',
　　　　　　　　3 => '牡羊座',
5 v6 ]  p" v4 K) d$ g　　　　　　　　4 => '金牛座',
8 J. v. n) k) E　　　　　　　　5 => '双子座',
7 o+ ]- h1 f' b+ _7 V1 F3 A% A　　　　　　　　6 => '巨蟹座',
　　　　　　　　7 => '狮子座',
　　　　　　　　8 => '座',
" i# k& N& F. ]8 B. J  g　　　　　　　　9 => '天秤座',
　　　　　　　　10 => '天蝎座',
　　　　　　　　11 => '射手座',
　　　　　　　　12 => '摩羯座'

& a; {- ?3 r" |! S3 [+ \　　　　　生肖：0 => '',
* @: k3 Y1 B* k- i( K, u　　　　　　　　1 => '鼠',
$ ^, ?) u* t: v8 L　　　　　　　　2 => '牛',
　　　　　　　　3 => '虎',
( j% l' T& W  J　　　　　　　　4 => '兔',
　　　　　　　　5 => '龙',
- P! W3 z: [; _! Q　　　　　　　　6 => '蛇',
　　　　　　　　7 => '马',
　　　　　　　　8 => '羊',
, h+ \1 ]) p) u6 A* p　　　　　　　　9 => '猴',
5 ~: q% l% v1 _　　　　　　　　10 => '鸡',
　　　　　　　　11 => '狗',
0 |1 j2 N2 G1 g* L( @' S( m7 D9 g　　　　　　　　12 => '猪'

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

(5).增加好友
, n- q# R0 {7 p7 W- B　　提交数据：VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号
, c1 `5 z; U# e- d2 a
　　返回：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号(需要验证)
: Q7 L' J+ u7 a　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=2&UN=对方QQ号(决绝被加为好友)
' i% {! u1 o0 z, I  c3 o0 @　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、UN为字符)

0 u+ e4 ~; l1 p6 B; w- x(5).发送验证
　　说明：1、如果你加对方为好友，你需要发送验证
( o/ V2 r( q: F7 L( t- @　　　　　2、对方加你为好友，发送了验证，你要通过或者拒绝
　　　　　这2种情况需要发送验证消息

　　提交数据：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号&CD=验证类型&RS=理由
　　说明：CD为0表示“通过验证”，CD为1表示“拒决加为对方为好友”，CD为2表示“为请求对方加为好友”。
" F; \; j0 k$ l( Q! i3 {! B+ Y
5 G3 s8 J4 x. L0 e5 k) X　　返回：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=0(成功)
7 F: b+ f# D# f  o/ u7 n　　　　　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。
; I" O) o" O! x0 E) e7 d4 e
/ C9 [, l0 Y. q) y, B4 h(6).删除好友
5 a, X" O6 A3 M: X8 g0 M　　提交数据：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&UN=删除的QQ号

　　返回：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=0&(成功)
( N1 L- ~4 g# U) P5 M5 Q　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=3(响应时间30s，重复发送的后果)
, J2 [7 K$ e; l　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
, j' r7 S' q& F- L" }　　　　　NULL(UIN、UN为字符)

5 I5 _4 ?% `; e  g3 ]. m8 T$ X( _(7).改变状态
$ h5 M! H* ]& I  R7 l　　提交数据：VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&ST=状态代码
/ u0 ?- a1 `, }! I/ D. ~　　说明：状态代码：10为上线，20为离线，30为忙碌，40为隐身，其他视为非法

　　返回：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非法)

　　特别说明：如果你改变好友，将会给所有好友发送一条系统信息，内容就是状态代码；如果隐身，发送的状态代码为20，表示离线。
  v1 r/ ~: R' c6 T0 Y( O' W5 t　　　　　　　同理，当你的好友改变状态，你也会收到一条系统信息。

/ P! W9 @3 O: j2 ^" E" S1 ~(9).获得消息
) d" {5 ?; G; V8 F- V' J4 Q　　提交数据：VER=1.1&CMD=GetMsgEx&SEQ=标记&UIN=QQ号
; ^' M9 I8 z4 \! ~3 Y$ F! b
. Q# K- e* E( v6 D　　返回：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为字符)
　　说明：关于MT：
　　　　　　　9为用户消息，99为系统消息，2为请求信息，3为通过验证，4为拒绝被加好友
　　　　　关于MG：
- P2 }- J2 }, f/ [& G- y, g　　　　　　　当MT=9时，MG为用户发送的消息内容
　　　　　　　当MT=99时,
9 R7 J$ |1 ]0 k3 O　　　　　　　　　MG=10(QQ_STATUS_ONLINE)表示对方上线
　　　　　　　　　MG=20(QQ_STATUS_OFFLINE)表示对方下线
& \& Q" S7 m) ^% X" I& U　　　　　　　　　MG=30(QQ_STATUS_BUSY)表示对方进入忙碌状态
　　　　　　　当MT=2时，MG为对方请求你验证的信息
: r6 P; c  H( m　　　　　　　当MT=3时，表示对方通过你的验证
　　　　　　　当MT=4时，MG为对方拒绝你理由
9 f$ B- |+ d( E0 J7 Q0 |
(10).发送消息
　　提交数据：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&UN=对方QQ号&MG=发送内容
; d" x2 L- F* J
8 a: ^; T3 P1 F* Z) {　　返回：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=0&(成功发送，对方不一定能收到哦)
. g$ }  i9 w. I9 {0 J　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=3(发送过快)
5 @  I7 h0 l% v3 j2 X　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
  S! x! \: ?' Q7 w( k3 h" ^　　　　　NULL(UIN、UN为字符，MG含非UTF-8字符)
　　说明：1、当你发消息时，以下情形对方可能看不到(其实是收到了，QQ不提示)你发送的消息：
　　　　　　　你俩互为陌生人，且对方没有和你说过话
　　　　　　　你在他的陌生人列表里，并且他没有和你说过话(没有验证)
1 l1 G7 M* g* ?( Y7 f6 p- V  D6 x　　　　　2、当你过快发送消息时，系统会给你一个惩罚，RES=3，相应时间20s
　　　　　3、当我发送含有小写字母h的信息时，服务器有可能返回NULL
+ }$ t3 ^( z) h2 ~% R  z4 K+ u$ Q& u
(11).登出
# A0 d' o- G% A; W; q: m　　提交数据：VER=1.1&CMD=Logout&SEQ=标记&UIN=QQ号

9 S5 j* e) A0 O7 L  U! i: T6 I　　返回：VER=1.1&CMD=LOGOUT&SEQ=标记&UIN=QQ号&RES=0(成功，好像永远成功的，不管你是否登陆)
　　　　　NULL(UIN为字符)

: V; L& g" K) o# D* W５、总结
8 G# H9 y3 E2 S; J
! c& |% |$ x- W* M! u　　通过对照以上的接口说明，我开发出了能够实现基本QQ功能的PHP类，它整合了以上所有的接口，使用更方便，可以开发QQ机器人、群发广告程序等。免费获得类的代码请到
　　http://blog.hackfan.net/index.ph ... d=a_20050819_223558
0 @% U4 A( p  T3 ]　　本文撰写时间仓促，难免有误，希望各位不吝赐教
; ]6 d# }* X0 A" l. f- z
" Q, w2 ]/ O( ^" ~
$ t1 M5 J7 C8 x5 k2 o$ OTrackback: http://tb.donews.net/TrackBack.aspx?PostId=520301