QQ的HTTP接口探究

天云上人

作者：Hackfan
日期：2005.8.21凌晨
7 |7 b$ R) H( Z' U- F; E  h- D联系：QQ:106814 Email:hackfan@vip.sina.com
$ M6 N  l0 {' l' S! X/ u
１、研究说明

" c- l/ O4 e5 b% B& k4 S. j　　Tencent在tqq.tencent.com的8000有一个使用HTTP的QQ接口，通过这个接口，可以进行一些基本的操作，如：登陆、登出、改变登陆状态(上线、忙碌、离线、隐身)、添加删除好友、查看好友信息、发送验证信息(接受被加为好友、申请加对方为好友、拒绝被加为好友)、收发用户消息、系统信息。
7 }5 J4 O* m9 h' A
! b! Y0 L0 A. J! m( ]$ {4 r　　目前我研究的是1.1版本的HTTP QQ协议，研究是微程在的成果上进行的，不敢说有什么超越，只不过更为详细和准确。

２、接口说明：
4 b, `4 a; Y" h! v# g7 t- {& X
　　接口位置：tqq.tencent.com:8000
4 V; c0 M. D( }" W# ^　　通信协议：HTTP
　　数据传输方法：POST
7 Z- i8 P, }% d- T% o! |& N　　HTTP请求格式：

POST HTTP/1.1
Host: tqq.tencent.com:8000
Content-Type: text/plain; charset=UTF-8
8 _6 @$ t2 S& a& ]* }7 |# JContent-length: 长度
* U" e* J8 w* }. Y+ d: aConnection: close

8 [4 o+ o4 R( L, o. Z* d* w8 w数据

　　其中长度为 数据 的长度，数据的格式：
* t+ m2 j: C; D8 I. @; s　　VER=1.1&CMD=命令&SEQ=标记&UIN=QQ号&....

, F4 x7 X: q6 Y0 R$ I　　以上４个参数是每个请求都必有的。其中，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还需要不同的参数，下面我就公布我的研究成果。
+ }8 }, R2 z0 [8 h* V8 m. M
３、研究方法：

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

1. <?
   
2. $uin = "QQ号";
   1 d7 E$ K/ O: u2 I
3. $pwd = md5("QQ密码");
   * a3 ^( j' _. [' Y2 T6 _
4. 
   / q) b4 i) q- Y; Y" M' z5 g
5. //登陆测试
   
6. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=1&LC=9326B87B234E7235";
   
7. //注意：登陆测试不能同时进行，必须等到服务器认为QQ断开了，才能够测试，不然结果不可信
   6 |: G# J  G5 U* A: V0 L+ Y! X
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";
    . }- D' p- Y/ M7 s
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";
    
15. *******/
    7 Q$ z/ h5 {+ G* n7 I) ^( e
16. 
    / V3 j4 m. I9 V; P% h+ U5 [6 `
17. 
    
18. //得到好友列表
    
19. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin;
    % y- k$ X3 w  m; C" y* \# U  e# |
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";
    . f) T8 U/ I$ }6 m! h
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);
    0 S) s" S5 {0 [
24. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=0";
    . O  I+ `# [+ h' T
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";
    3 a, @! g0 c+ _
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);
    2 o0 V- l. [$ ]0 z. z  g
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);
    6 T; J+ I$ u4 S4 ^
33. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=106814";
    
34. 
    
35. //得到在线列表
    ( Z5 B3 Z4 f) X  \
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";
    * p( l& p5 G; _0 c7 `) x/ N$ ]
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";
    : O- }; g/ o0 |
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";
    
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";
    % K7 v  Y! T2 ~0 f
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);
    - g$ [( V& T: H& h* H9 Y- R
48. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    , a0 h# \2 G, y2 ?- A2 Z
49. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    ) ?/ |  d3 B6 d8 X
50. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=106814";
    1 `- P& f0 z1 W& D3 d
51. 
    . O; U; e; r+ V! `; r
52. //查看好友信息
    
53. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=0&UN=106814";
    ( |: A  x1 K* d- q" s9 f- z, o$ t
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";
    
56. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=3&UN=106814";
    
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. //增加好友
    & ^* j3 i, T* t3 b
61. $poststring[] = "VER=1.1&CMD=AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    ) g3 B3 L5 ?1 v- n
62. 
    $ u4 {9 c& c  u% r% p) R
63. //发送验证
    , I( B% e4 E& S; \, {5 ~
64. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=0&RS=TEST";
    # J6 E, _5 k5 {! I- R# ~( u- \
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";
    
67. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=3&RS=TEST";
    / t4 ~/ T- `) v
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";
    0 p1 s9 ]+ O1 b, ?( a
70. 
    8 h, q9 T/ j' F" t1 f- C- |7 q
71. //删除好友
    / J) V2 V( f  {2 g4 W) @8 N; ~
72. $poststring[] = "VER=1.1&CMD=DelFromList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    & B( g: ]! v( w# J! r, M
73. 
    
74. //改变状态
      I3 r$ G0 E6 x, _. u4 |
75. for($i=0;$i<=60;$i=$i+5)
    9 z9 ?% \1 l/ O! F8 _1 }& T, l6 P
76. {
    
77. $poststring[] = "VER=1.1&CMD=Change_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&ST=".$i;
    2 Q9 F. y' r( }7 d
78. }
    
79. 
    , \3 f& \) W! e+ x
80. //获得消息
    9 }4 z2 m6 \5 C8 u; K
81. $poststring[] = "VER=1.1&CMD=GetMsgEx&SEQ=".rand(1000,9000)."&UIN=".$uin."";
      H. w. J6 E- t' r% _. w
82. 
    - z1 W& s; ^' `4 |$ H
83. //发送消息
    % J0 Y$ d- Z* I7 H6 o
84. $poststring[] = "VER=1.1&CMD=CLTMSG&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&MG=TEST";
    
85. 
    " K+ P9 e5 b. O) I1 G  t
86. //登出
    
87. $poststring[] = "VER=1.1&CMD=Logout&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    
88. 
    
89. $file = fopen("p.txt","w");
    : T, G$ O; Q! i! c
90. 
    
91. foreach($poststring as $k=>$v)
    
92. {
    2 [; @$ P9 N2 V9 N( w7 z5 c
93. ss_timing_start();
    
94. $fp = fsockopen('tqq.tencent.com', '8000', $errno, $errstr, $timeout = 10);  
    
95. 
    9 o0 F5 z+ \' N0 \/ R
96. if(!$fp){  
    ; D# f' j$ J1 p& p8 c
97. //error tell us  
    
98. $content = $k.chr(13).chr(10)."ERROR:$errstr ($errno)";  
    : e1 n2 L% v  T
99.    
    
100. }else{  
     , T, C1 Q% o; j. C
101. 
     ; z; ]: K9 q/ [' E; D- m6 `
102.   //send the server request  
     
103.   fputs($fp, "POST HTTP/1.1\r\n");  
     ( N# Q2 B# @" F3 z+ z
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");  
     
107.   fputs($fp, "Connection: close\r\n\r\n");  
     
108.   fputs($fp, $v . "\r\n\r\n");  
     * ]; s- l! ]) x0 u
109. 
       X5 s" R- o# ~+ ^
110.   //loop through the response from the server  
     
111.   $res = "";
     
112.   while(!feof($fp)) {  
     
113.   $res .= fgets($fp, 4096);  
     * \; G- j  o+ h! |4 j# M$ x
114.   }  
     7 y7 |& m7 S2 D
115.   //close fp - we are done with it  
     
116.   fclose($fp);  
     8 }! J% c+ ]$ ~; D9 B- g
117. 
     
118.   $content = $v.chr(13).chr(10).$res;
     2 q# v+ ^: B8 u# v0 q: Z1 `" e2 v/ H
119. }  
     
120. ss_timing_stop();  
     0 s# C0 G5 W# K* I
121. $content .= chr(13).chr(10)."Time: ".ss_timing_current().chr(13).chr(10)."--------------------------------------".chr(13).chr(10);
     
122. fputs($file,$content);
     / }: z" P" B+ E9 C1 a
123. }
     1 U5 A( p! W7 V4 x
124. fclose($file);
     
125. ?>
     
126. <?
     
127. function ss_timing_start ($name = "default") {  
     
128. global $ss_timing_start_times;  
     1 O) I  T/ l  V/ H2 t
129. $ss_timing_start_times[$name] = explode(' ', microtime());  
     
130. }  
       ^" D9 u( L: z( E6 O& ?" C9 e
131. function ss_timing_stop ($name = "default") {  
     
132. global $ss_timing_stop_times;  
     . F/ h7 `- m* M1 s& Y  i
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;  
     
137. if (!isset($ss_timing_start_times[$name])) {  
     
138. return 0;  
     # D( u' Q0 p3 Z" S- l
139. }  
     
140. if (!isset($ss_timing_stop_times[$name])) {  
     / Z6 L- I- g( R
141. $stop_time = explode(' ', microtime());  
     * Y. q- d* W8 x/ C
142. }  
     0 o, S* r/ K1 y# I
143. else {  
     2 O* x6 D; P- V% z) V+ Y# T& O
144. $stop_time = $ss_timing_stop_times[$name];  
     
145. }  
     / p* H( p( d" Z+ Y' j- }
146. $current  =  $stop_time[1]-$ss_timing_start_times[$name][1];  
     # h% T: S9 m# M4 g$ F3 o
147. $current += $stop_time[0]-$ss_timing_start_times[$name][0];  
     
148. return $current;  
     ' D# x) F3 i+ n: F
149. }  
     7 b% [! ~  a- e) E; q' q9 z! j7 m9 S/ g
150. ?>

复制代码

４、研究成果：

(1).登陆
　　说明：在你做任何其他操作以前，你必须登陆。只有在登陆以后，你的其他指令才有可能被正确执行(返回RES=0)，不然服务器会返回RES= 20，不过有个例外，就是logout。当你成功登陆以后，服务器就会根据你的IP*和参数中的UIN来验证身份。一台电脑可以同时登陆多个QQ，互不影响，就是因为有参数UIN。
　　*至于我能够确定服务器是通过IP来验证的，是因为服务器不可能通过我的请求获得其他信息了^_^
/ v. L1 G& D7 M4 O1 E  i5 }1 b
6 o# y8 E8 h- d( T　　提交数据：VER=1.1&CMD=Login&SEQ=标记&UIN=QQ号&PS=QQ密码&M5=1&LC=9326B87B234E7235
　　说明：QQ密码是通过md5加密的字符串，在PHP中可以直接用md5()进行加密；
8 F! O3 N* L5 v; u　　　　　M5这个参数的作用还不清楚，但最好为1。
3 t& V" P: Y7 Y! ^8 ?* S　　　　　LC这个参数有点神秘，不能有丝毫改动，不然服务器就没有响应(没有响应就是返回NULL)。
; i' q9 }9 m! X0 z) i
　　返回：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错误)
/ N9 O8 J3 n6 Z
" O# E+ n- v! D) w5 m/ m(2).得到好友列表
; e- k4 e5 c. W+ I6 ]　　提交数据：VER=1.1&CMD=List&SEQ=标记&UIN=QQ号&TN=160&UN=0
　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响

4 S- t5 U  A* M. D6 ~" \. k$ W　　返回：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(没有正确登陆)
　　　　　NULL(UIN、TN、UN为字符)

(3).得到在线好友列表
　　提交数据：VER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号&TN=50&UN=0
4 |# L4 |4 J) ^& V2 r- z. @　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响
" p5 s" r/ [( ^7 T( _4 I
　　返回：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(没有正确登陆)
　　　　　NULL(UIN、TN、UN为字符)
6 i* k8 h) [6 V" h4 H　　说明：FC为QQ头像的的ID，如的头像ID为270，那么其头使用的图片为91.bmp,其算法为ID/3+1；
　　　　　ST为QQ用户的状态，10为上线，20为离线(或隐身)，30为忙碌；
' W* `) x- t4 c- ]( `
　　特别说明：当参数TN=0或不存在时，服务器返回：
2 A5 @* u& h6 t) nVER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号
HTTP/1.1 200 OK
& c9 z9 g& H0 v7 [3 s9 O8 Y" AServer: tencent imserver/1.0.0
# |, L% C+ G' V  aContent-Type: text/plain; charset=UTF-8
9 z7 x1 ~0 c1 ~7 v. D4 h# JContent-Length: 56

* I: c( R6 I( X& B' oVER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FN=1
- Q* b: _% r& \6 NHTTP/1.1 200 OK
8 s: F$ }4 @! X: A( p+ u0 iServer: tencent imserver/1.0.0
, |9 a+ t) s) [- c0 zContent-Type: text/plain; charset=UTF-8
Content-Length: 77

/ ~8 ?+ b6 m  M$ r8 v# [% RVER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FC=&FN=1&SN=0&ST=&UN=&NK=
　　返回了２次，第一次的结果中，FN为在线好友数，第二次返回的数据基本没用。
  S! \8 {" l$ j0 I" p/ f
(4).查看好友信息
　　提交数据：VER=1.1&CMD=GetInfo&SEQ=标记&UIN=QQ号&LV=查询类型&UN=被查询QQ号码
　　说明：LV=0,1为精简查询，LV=2为普通查询，LV>=3为详细查询
8 F7 L: c, u2 }
　　返回：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=学生
! @" V: g; q0 r- M4 x7 s( h# |% o&LV=2&PC=邮编&PH=电话&PR= The guy is updating to .NET Frameword......&PV=江苏&RN=胡吉阳&SC= 毕业院校&SX=0&UN=106814&NK=Hackfan  
好(普通查询)
" k  r. O0 W% |, l+ E  n( f　　　　　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 Y& m, s8 d7 [2 G. U) c$ B( N5 ^　　　　　VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、LV、UN为字符)

　　说明：AD为联系地址
  |# i" \) V- x' u0 m　　　　　AG为年龄
　　　　　BT为血型
　　　　　CO为星座
　　　　　CT为城市
　　　　　CV为未知*
% Y0 m1 c& r  Y( C　　　　　CY为国家
　　　　　EM为Email
0 e2 P' g% t( N  a: `# r　　　　　FC为头像
: D! q. D8 G& D  R$ P　　　　　HP为网站
  h+ v( W, Q6 L0 d' L# U7 J　　　　　ID为未知
　　　　　JB为职业
　　　　　LV为查询代码(就是发送的LV)
　　　　　MO为移动电话
5 I8 E4 a/ D9 S/ Q: Y, y　　　　　MT为未知
. c* U5 d. D& L* Q　　　　　MV为未知
- \, p% |6 w+ i( |. w( }　　　　　PC为邮编
　　　　　PH为联系电话
  D$ v9 Y9 M2 E. v" M9 h　　　　　PR为简介
　　　　　PV为省
" [# K# I7 L: }, ^7 m7 t) g* @　　　　　RN为真实姓名
　　　　　SC为毕业院校
　　　　　SH为生肖
+ A, v8 c& W% Q- ^2 u* A　　　　　SX为性别
　　　　　UN为QQ号
+ G8 g8 j% Z3 H! k# _( F　　　　　NK为昵称
+ z9 h' ?% F! ]( e  r
　　　　　血型：0 => '',
　　　　　　　　1 => 'A型',
　　　　　　　　2 => 'B型',
　　　　　　　　3 => 'O型',
　　　　　　　　4 => 'AB型',
　　　　　　　　5 => '其他'


9 b: n4 A, z$ P/ e/ n　　　　　星座：0 => '',
4 C" N5 V. z6 C5 P　　　　　　　　1 => '水瓶座',
　　　　　　　　2 => '双鱼座',
4 W) Q) Z7 f. q% L& t　　　　　　　　3 => '牡羊座',
( g# w4 t: }+ j7 y* ~4 ^9 C. r3 ?　　　　　　　　4 => '金牛座',
　　　　　　　　5 => '双子座',
* T; B" V& T# r# H5 y3 S. {; \' T　　　　　　　　6 => '巨蟹座',
　　　　　　　　7 => '狮子座',
　　　　　　　　8 => '座',
/ A3 x0 O( C, C7 _　　　　　　　　9 => '天秤座',
# N& {# j; k/ _8 p( ]9 n　　　　　　　　10 => '天蝎座',
　　　　　　　　11 => '射手座',
　　　　　　　　12 => '摩羯座'
; w% J7 N; W' K5 B8 Y% t
　　　　　生肖：0 => '',
　　　　　　　　1 => '鼠',
　　　　　　　　2 => '牛',
　　　　　　　　3 => '虎',
/ c- @' ?+ A) J$ m) o　　　　　　　　4 => '兔',
　　　　　　　　5 => '龙',
7 Q  e* z( `/ c. d　　　　　　　　6 => '蛇',
  |' [  O# w  X. O* y7 ]* N　　　　　　　　7 => '马',
　　　　　　　　8 => '羊',
; k. j9 E5 I# c% V$ {( J2 |　　　　　　　　9 => '猴',
. }3 K8 P6 ]# z9 ?　　　　　　　　10 => '鸡',
　　　　　　　　11 => '狗',
　　　　　　　　12 => '猪'
/ }* k8 {0 X  ~7 ^* U
　　　　　性别：0 => '男',
- M& a8 V8 J9 C+ u! Q2 Y　　　　　　　　1 => '女'
( r4 L! P5 z1 U0 a
(5).增加好友
' O" X% \+ D: y* [% e' e+ K　　提交数据：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(没有正确登陆)
; C+ j5 P9 A/ N% g　　　　　NULL(UIN、UN为字符)

! N  U# r$ O5 V(5).发送验证
　　说明：1、如果你加对方为好友，你需要发送验证
& z5 l# C, [' f# l　　　　　2、对方加你为好友，发送了验证，你要通过或者拒绝
　　　　　这2种情况需要发送验证消息
: p9 P  k% g. |! B1 B# a' p+ z6 N
　　提交数据：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号&CD=验证类型&RS=理由
& _8 a+ {! q1 S! s* p( g　　说明：CD为0表示“通过验证”，CD为1表示“拒决加为对方为好友”，CD为2表示“为请求对方加为好友”。
4 k) h$ M+ t: M. z' g1 f7 M
; f! k# X2 ^6 K4 r4 L$ M% S: l　　返回：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=0(成功)
: d9 U2 c. f& e" f8 S! q' M/ j　　　　　VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=3(*)
1 f8 L7 X: N# C3 V7 h　　　　　VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、UN、CD为字符，RS为非UTF-8字符)
4 v! s7 \7 b* O9 y2 B　　*如果服务器返回RES=3，那么这次对话的响应时间在20s。当发送验证请求的时候，必须连发2次(请求内容不必一样)，其中一条RES=3，对方收不到，一条RES=0，对方能够收到。当CD>=3时，RES=3，响应时间20s。
9 U' [* m4 ~/ X, x6 E" v! R
9 T; e  ?/ d+ \' A(6).删除好友
　　提交数据：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&UN=删除的QQ号
  q. Q0 G1 t$ B7 p; ~) }+ y" G
% i' z2 V! A* P' ~" l$ O　　返回：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=0&(成功)
　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=3(响应时间30s，重复发送的后果)
2 ~2 H1 @& {9 _' H# n　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
9 |4 o6 e! P) g$ W" g8 w6 |　　　　　NULL(UIN、UN为字符)

(7).改变状态
　　提交数据：VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&ST=状态代码
　　说明：状态代码：10为上线，20为离线，30为忙碌，40为隐身，其他视为非法
+ M: F( Z; J& J# G3 H
　　返回：VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=0&(成功)
" O% {' B) l! p) i) e0 x0 F2 b　　　　　VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=3(失败，原因不明，响应时间20s，可能是过于频繁的改变状态引起的)
　　　　　VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
6 E) y/ l9 Z5 f. G5 ?　　　　　NULL(UIN为字符，ST非法)
+ j) i, Q8 }* O( h6 A% Z4 l/ ~  i
　　特别说明：如果你改变好友，将会给所有好友发送一条系统信息，内容就是状态代码；如果隐身，发送的状态代码为20，表示离线。
! J* S" C5 T$ Y' z7 K7 T' e　　　　　　　同理，当你的好友改变状态，你也会收到一条系统信息。

# O% E8 r. e' {) x(9).获得消息
/ ^7 s* g; `2 a/ K　　提交数据：VER=1.1&CMD=GetMsgEx&SEQ=标记&UIN=QQ号
! [6 [  K0 ]$ F
　　返回：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(没有正确登陆)
& b8 t& i- M5 x7 f  q　　　　　NULL(UIN为字符)
　　说明：关于MT：
! r1 u5 l6 u& N; q　　　　　　　9为用户消息，99为系统消息，2为请求信息，3为通过验证，4为拒绝被加好友
　　　　　关于MG：
  i; E5 t8 n0 r- @" [* V　　　　　　　当MT=9时，MG为用户发送的消息内容
　　　　　　　当MT=99时,
2 I! W& P" l. v1 h7 ~% s2 |　　　　　　　　　MG=10(QQ_STATUS_ONLINE)表示对方上线
- y7 d( K; @: Q2 L6 a/ O　　　　　　　　　MG=20(QQ_STATUS_OFFLINE)表示对方下线
/ J4 S. r8 ]/ F3 E! M- u2 _6 h( f3 q! ?0 h　　　　　　　　　MG=30(QQ_STATUS_BUSY)表示对方进入忙碌状态
8 P+ V" j8 X- w, W4 i; q: w　　　　　　　当MT=2时，MG为对方请求你验证的信息
　　　　　　　当MT=3时，表示对方通过你的验证
　　　　　　　当MT=4时，MG为对方拒绝你理由
* S! m% K, g" E1 q
6 j; |+ [: ^$ P, j4 _0 w1 S5 u(10).发送消息
　　提交数据：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&UN=对方QQ号&MG=发送内容
8 P7 R& W5 r' Z) {
　　返回：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=0&(成功发送，对方不一定能收到哦)
　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=3(发送过快)
! h0 B- Z  @4 A/ A0 a' D　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
+ \+ k$ V) O: I9 r" H4 s  D　　　　　NULL(UIN、UN为字符，MG含非UTF-8字符)
　　说明：1、当你发消息时，以下情形对方可能看不到(其实是收到了，QQ不提示)你发送的消息：
, ?. J1 Q6 K6 u  H% I( `" o　　　　　　　你俩互为陌生人，且对方没有和你说过话
) b2 l, T4 ^+ p1 N* q" I# i　　　　　　　你在他的陌生人列表里，并且他没有和你说过话(没有验证)
　　　　　2、当你过快发送消息时，系统会给你一个惩罚，RES=3，相应时间20s
8 e. M; j/ [+ X4 C  w# s0 E% d　　　　　3、当我发送含有小写字母h的信息时，服务器有可能返回NULL
& h3 m! n+ s- o4 T' k
: v( m* x" R% W( p) M: Y(11).登出
　　提交数据：VER=1.1&CMD=Logout&SEQ=标记&UIN=QQ号
* ^5 d8 A9 F* Z, a
! U! Z" r/ q4 h8 q　　返回：VER=1.1&CMD=LOGOUT&SEQ=标记&UIN=QQ号&RES=0(成功，好像永远成功的，不管你是否登陆)
. ^8 }5 Q6 G& g% w0 H　　　　　NULL(UIN为字符)
, K- N( t6 N. ?1 p  Y2 X( A/ _$ B
: O' H& J/ x0 I9 h. h1 t8 `５、总结

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


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