QQ的HTTP接口探究

天云上人

作者：Hackfan
日期：2005.8.21凌晨
- e* c3 _: e& {# d" U联系：QQ:106814 Email:hackfan@vip.sina.com

+ a4 x& t; v5 H# o1 t１、研究说明

! A( S3 I2 T3 V. O3 Z) P) }　　Tencent在tqq.tencent.com的8000有一个使用HTTP的QQ接口，通过这个接口，可以进行一些基本的操作，如：登陆、登出、改变登陆状态(上线、忙碌、离线、隐身)、添加删除好友、查看好友信息、发送验证信息(接受被加为好友、申请加对方为好友、拒绝被加为好友)、收发用户消息、系统信息。

　　目前我研究的是1.1版本的HTTP QQ协议，研究是微程在的成果上进行的，不敢说有什么超越，只不过更为详细和准确。

２、接口说明：

　　接口位置：tqq.tencent.com:8000
& Z) s0 |" L) [' y1 X9 d　　通信协议：HTTP
5 |1 a, H0 s" Z; R　　数据传输方法：POST
　　HTTP请求格式：

POST HTTP/1.1
) _' R7 n3 y* N+ WHost: tqq.tencent.com:8000
- z0 d! _+ ^% W5 t1 pContent-Type: text/plain; charset=UTF-8
Content-length: 长度
$ o. Q: W5 P* g: p' }( J. nConnection: close
$ u% U' V: f0 X- [; Y( t& Q% x
: c$ z) v5 U. h" l9 ~1 r2 d数据
  ^) b5 i+ ]# P% v
5 u0 [$ U  t0 p$ _　　其中长度为 数据 的长度，数据的格式：
8 ?6 I: c+ t# H8 s* y7 @; r　　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还需要不同的参数，下面我就公布我的研究成果。
: _- g" @0 F5 r3 K
) X5 \/ T9 y+ P３、研究方法：

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

1. <?
   
2. $uin = "QQ号";
   
3. $pwd = md5("QQ密码");
   1 I" y2 g) N+ [' v
4. 
   
5. //登陆测试
   ; V( g9 p8 u" ^) H3 c1 N
6. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=1&LC=9326B87B234E7235";
   
7. //注意：登陆测试不能同时进行，必须等到服务器认为QQ断开了，才能够测试，不然结果不可信
   
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";
    $ a1 v0 N# e& s; k) H
11. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=2&LC=9326B87B234E7235";
    ) p- N6 u9 I7 b1 _/ V2 O
12. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=3&LC=9326B87B234E7235";
    % f" K  P# a! U, |( ~8 o
13. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M6=1&LC=9326B87B234E7235";
    ' j7 @1 Z. H. Z1 C- p- n9 z
14. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M6=1&LC=1223423545756679";
    
15. *******/
    
16. 
    
17. 
    
18. //得到好友列表
    # s; E- }; p3 u6 h
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";
      Z( S9 m0 X* }2 e0 Q
22. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=0";
    ; K! x9 A$ f3 ^
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";
    
25. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    ' ]& y4 P- N9 Y" o6 k# y* n
26. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    
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";
    0 Q2 _. r* B# H, T6 R  e, O
29. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    6 o! f0 K2 e* B: L; }" l
30. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    0 S( W- B* J( o1 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);
    7 x$ R3 `2 m9 ^1 o6 ?. M
33. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=106814";
    
34. 
    ! `, D' x0 f6 A" t. _! B: r
35. //得到在线列表
    $ Z4 K8 f6 E' N, h: j9 P/ v
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";
    : f# W/ P8 {6 v7 @& l4 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";
    
40. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=".rand(1,10);
    " l' |' S; d8 D; I
41. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=0";
    ( A8 C/ A' Y1 V& v3 q6 {2 X1 @
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";
    ' P# }6 L$ z0 Q3 L4 G% T2 W
44. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    ; @4 l/ Y3 n( A* r2 `
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);
    . `1 o; B/ O: Q( |
48. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    4 v4 J- c5 L( o2 S2 @9 e! y
49. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    2 I/ Y+ L' l  C' O- S
50. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=106814";
    " t5 u: `: }' r3 A
51. 
    7 b  X' b% `7 A; c1 X
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";
    
56. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=3&UN=106814";
    9 ^+ L  ^5 q$ U0 n
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";
    . {: l) |. |0 s% R- ]0 O2 x
59. 
    
60. //增加好友
    # r! C* M' }; M% @2 G. ?7 S
61. $poststring[] = "VER=1.1&CMD=AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    4 w7 u  Z8 l" b' |: h% q+ L
62. 
    : J# o" D$ P! T4 T) A/ k
63. //发送验证
    , l& H0 z' F: g( ?
64. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=0&RS=TEST";
    0 }4 _& G9 O" f$ t
65. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=1&RS=TEST";
      `) M: F1 h9 u6 e, o5 ?* I
66. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=2&RS=TEST";
    / v1 u: T0 c: |6 ^: b2 r' ]
67. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=3&RS=TEST";
    
68. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=4&RS=TEST";
      _9 d+ _5 E. `7 z4 O( r
69. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=5&RS=TEST";
    # B5 V) [/ i6 T9 ~# H
70. 
    0 c5 l# Y  d/ K5 ~6 s6 f) M+ E
71. //删除好友
    
72. $poststring[] = "VER=1.1&CMD=DelFromList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    
73. 
    
74. //改变状态
    
75. for($i=0;$i<=60;$i=$i+5)
    
76. {
    
77. $poststring[] = "VER=1.1&CMD=Change_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&ST=".$i;
    
78. }
    
79. 
    
80. //获得消息
    
81. $poststring[] = "VER=1.1&CMD=GetMsgEx&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    9 Y. C0 q6 F. k+ m5 `8 N
82. 
    ; v, E) s6 ], m, _3 A& ^: Q
83. //发送消息
    9 G/ J: l# ~5 i3 Y7 }% T5 s
84. $poststring[] = "VER=1.1&CMD=CLTMSG&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&MG=TEST";
    
85. 
    
86. //登出
    0 J. p6 M2 T. {6 H$ M, q
87. $poststring[] = "VER=1.1&CMD=Logout&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    
88. 
    $ P) L% q% y* C1 q; ^
89. $file = fopen("p.txt","w");
    * q2 p% \9 d3 T* t! u
90. 
    ; z. A& v/ \# C3 G1 B9 R: c% w9 ]
91. foreach($poststring as $k=>$v)
    1 z6 A+ S) H$ g7 E0 V; U
92. {
    ( F. {# c# x6 {4 P- l
93. ss_timing_start();
    
94. $fp = fsockopen('tqq.tencent.com', '8000', $errno, $errstr, $timeout = 10);  
    
95. 
    ) G* y; G1 Q0 m$ u+ e  ^
96. if(!$fp){  
    
97. //error tell us  
    
98. $content = $k.chr(13).chr(10)."ERROR:$errstr ($errno)";  
    - v# b" A8 Y2 ~# w* D
99.    
    
100. }else{  
     0 Q* G& W) l6 C5 A$ v
101. 
     ( Q5 l) _- t5 n. v# p
102.   //send the server request  
     3 M0 ?3 M! s" X1 _3 ~
103.   fputs($fp, "POST HTTP/1.1\r\n");  
     ; X/ u4 Q; z. R7 }
104. //  fputs($fp, "Host: $host\r\n");  
     , Q2 }  J; U; @. f
105. //  fputs($fp, "Content-type: application/x-www-form-urlencoded\r\n");  
     7 f! d3 E' b* d' s6 Q
106.   fputs($fp, "Content-length: ".strlen($v)."\r\n");  
     
107.   fputs($fp, "Connection: close\r\n\r\n");  
     * `' ^. k6 Q1 j/ l2 b( r
108.   fputs($fp, $v . "\r\n\r\n");  
     
109. 
     
110.   //loop through the response from the server  
     
111.   $res = "";
     & o8 f4 _$ @1 v5 \( W
112.   while(!feof($fp)) {  
     
113.   $res .= fgets($fp, 4096);  
     1 u8 h/ F: y3 l2 [8 X6 H
114.   }  
     
115.   //close fp - we are done with it  
     
116.   fclose($fp);  
     5 T% }& G8 i+ m: P2 v+ @6 x
117. 
     : }/ s* {2 w1 F7 ^( j, o+ ]% |
118.   $content = $v.chr(13).chr(10).$res;
     
119. }  
     & \8 k2 G6 a1 _# A
120. ss_timing_stop();  
       k3 _5 f/ i4 X+ b3 G- ~+ q
121. $content .= chr(13).chr(10)."Time: ".ss_timing_current().chr(13).chr(10)."--------------------------------------".chr(13).chr(10);
     ( B$ f6 ~7 O% `& o  j7 v
122. fputs($file,$content);
     ' I0 g7 x8 U1 C
123. }
     7 ~1 F6 @/ S+ P& b8 b
124. fclose($file);
     
125. ?>
     
126. <?
     : @/ T2 {) I2 v  y
127. function ss_timing_start ($name = "default") {  
     * Y; \5 c& }6 m$ N  |
128. global $ss_timing_start_times;  
     + r8 y) Y/ C1 M3 [) o
129. $ss_timing_start_times[$name] = explode(' ', microtime());  
     ; n. T/ z, U9 ~; j3 u- A
130. }  
     2 q! ~- V- K8 m8 F3 ]8 [
131. function ss_timing_stop ($name = "default") {  
       l+ ~. B" T9 F: l7 Y- |. M
132. global $ss_timing_stop_times;  
     $ b. A+ [  a9 n* C8 t% |/ P
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;  
     7 d4 c2 x& K; i, V
137. if (!isset($ss_timing_start_times[$name])) {  
     
138. return 0;  
     
139. }  
     . T% w* ~7 Q6 ~+ K) H
140. if (!isset($ss_timing_stop_times[$name])) {  
     
141. $stop_time = explode(' ', microtime());  
     ) ]) B8 J& H! j% P1 Y" g; N
142. }  
     $ Y; k) l$ V& y+ u
143. else {  
     
144. $stop_time = $ss_timing_stop_times[$name];  
     
145. }  
     
146. $current  =  $stop_time[1]-$ss_timing_start_times[$name][1];  
     : X2 N4 l+ {. L( L7 ^
147. $current += $stop_time[0]-$ss_timing_start_times[$name][0];  
     4 t! N0 V# [3 I& H& n9 g& d
148. return $current;  
     
149. }  
     * E  d. u( L3 u5 Q
150. ?>

复制代码

４、研究成果：

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

　　提交数据：VER=1.1&CMD=Login&SEQ=标记&UIN=QQ号&PS=QQ密码&M5=1&LC=9326B87B234E7235
　　说明：QQ密码是通过md5加密的字符串，在PHP中可以直接用md5()进行加密；
2 G. ~! {1 V7 E7 c$ d! S　　　　　M5这个参数的作用还不清楚，但最好为1。
: Y) [8 ]7 C1 j, s  ^! P2 f- I; O　　　　　LC这个参数有点神秘，不能有丝毫改动，不然服务器就没有响应(没有响应就是返回NULL)。
% P/ K9 [( y- h. B+ e7 G9 V
　　返回：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错误)
  Q/ v6 S+ }5 d3 ]- w' h! ]
(2).得到好友列表
　　提交数据：VER=1.1&CMD=List&SEQ=标记&UIN=QQ号&TN=160&UN=0
　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响

　　返回：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(没有正确登陆)
) e% e5 |3 D4 E　　　　　NULL(UIN、TN、UN为字符)
5 y. I! h9 S0 s
(3).得到在线好友列表
　　提交数据：VER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号&TN=50&UN=0
- B: c  }; j- {$ I+ K. F　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响

, A4 p! L' ]7 U2 T; f; X　　返回：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(没有正确登陆)
% X; t: m! V2 A* A　　　　　NULL(UIN、TN、UN为字符)
/ d0 h5 L4 I1 O! y+ X) O　　说明：FC为QQ头像的的ID，如的头像ID为270，那么其头使用的图片为91.bmp,其算法为ID/3+1；
　　　　　ST为QQ用户的状态，10为上线，20为离线(或隐身)，30为忙碌；
2 y) H; J7 S% {2 I  k2 e
/ H2 y! b  c2 Q　　特别说明：当参数TN=0或不存在时，服务器返回：
) e& r+ h9 z+ B, a0 Z/ qVER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号
: K+ c# \: m/ sHTTP/1.1 200 OK
Server: tencent imserver/1.0.0
Content-Type: text/plain; charset=UTF-8
Content-Length: 56

VER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FN=1
; _# \& u2 n: s) i# ^" iHTTP/1.1 200 OK
' K2 V7 a4 l* ?& tServer: tencent imserver/1.0.0
" _6 C( ^$ O) oContent-Type: text/plain; charset=UTF-8
Content-Length: 77

5 V" e; z. d# T) [9 c) xVER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FC=&FN=1&SN=0&ST=&UN=&NK=
0 F- e8 [+ |& d1 A4 F+ v8 g　　返回了２次，第一次的结果中，FN为在线好友数，第二次返回的数据基本没用。

(4).查看好友信息
　　提交数据：VER=1.1&CMD=GetInfo&SEQ=标记&UIN=QQ号&LV=查询类型&UN=被查询QQ号码
　　说明：LV=0,1为精简查询，LV=2为普通查询，LV>=3为详细查询
9 y0 z. Z  j3 r% Q$ C( t% E
　　返回：VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=0&LV=0&UN=106814&NK=Hackfan 好(精简查询)
1 X6 M2 v3 F% H  d7 H8 f' M8 M　　　　　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=学生
3 B' \$ y& K. e&LV=2&PC=邮编&PH=电话&PR= The guy is updating to .NET Frameword......&PV=江苏&RN=胡吉阳&SC= 毕业院校&SX=0&UN=106814&NK=Hackfan  
; U7 I" M7 R+ M6 b( E% q好(普通查询)
; m7 t2 a, D5 e* E　　　　　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 好(详细查询)
1 Y7 }; i" W: V9 a% I7 T　　　　　VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
. g5 s* m+ J% k' c　　　　　NULL(UIN、LV、UN为字符)

　　说明：AD为联系地址
　　　　　AG为年龄
　　　　　BT为血型
$ K8 P5 [4 ]9 ~4 `( g# a. S　　　　　CO为星座
7 d. `; x9 m$ P- g& X　　　　　CT为城市
& }' f  a" W7 [2 |  X9 T　　　　　CV为未知*
　　　　　CY为国家
　　　　　EM为Email
. N# [7 m, B# F　　　　　FC为头像
! l, v! ?  @7 [5 e: M0 {　　　　　HP为网站
　　　　　ID为未知
6 j4 s; l; H0 x, b% F3 I　　　　　JB为职业
) M4 Y+ q" r2 r' I7 Y3 C　　　　　LV为查询代码(就是发送的LV)
　　　　　MO为移动电话
! R; }$ j( X( v! N6 k8 i9 u　　　　　MT为未知
. \. \2 P; K% D4 a7 O% \　　　　　MV为未知
- y& ~$ d5 Y* t$ b: {  T- ~　　　　　PC为邮编
　　　　　PH为联系电话
' R- H' s  H4 H1 O　　　　　PR为简介
　　　　　PV为省
3 w6 E0 q, L8 V5 i! l　　　　　RN为真实姓名
　　　　　SC为毕业院校
4 S. m, e3 c3 ~1 h　　　　　SH为生肖
# {" E8 S9 w9 y　　　　　SX为性别
　　　　　UN为QQ号
　　　　　NK为昵称

9 d* C' ?/ H# f/ a2 ^( M　　　　　血型：0 => '',
  t3 ]; [6 A: U* N& \% h% O　　　　　　　　1 => 'A型',
' D6 J4 U* ~( Y/ L　　　　　　　　2 => 'B型',
　　　　　　　　3 => 'O型',
: ~9 s" b4 W4 s$ _/ a: P　　　　　　　　4 => 'AB型',
　　　　　　　　5 => '其他'
7 t: N, u' H; I0 u8 n) M+ z  ]

　　　　　星座：0 => '',
　　　　　　　　1 => '水瓶座',
　　　　　　　　2 => '双鱼座',
　　　　　　　　3 => '牡羊座',
　　　　　　　　4 => '金牛座',
　　　　　　　　5 => '双子座',
( h* m/ d% r% p% ~* ?" I: |　　　　　　　　6 => '巨蟹座',
' y( c  w% n9 J7 q1 r9 R　　　　　　　　7 => '狮子座',
  d# g% K8 }5 S8 P/ l. U. ]　　　　　　　　8 => '座',
7 J' a( K7 o7 A4 p; f3 x　　　　　　　　9 => '天秤座',
0 P7 y: g1 J8 p' W, B) d$ U% O　　　　　　　　10 => '天蝎座',
　　　　　　　　11 => '射手座',
　　　　　　　　12 => '摩羯座'

　　　　　生肖：0 => '',
% k, h  P4 s# U! [8 F5 a) Q　　　　　　　　1 => '鼠',
　　　　　　　　2 => '牛',
　　　　　　　　3 => '虎',
9 |, Z2 V- y6 C" I% }  j) _　　　　　　　　4 => '兔',
6 t: q. \- i: M　　　　　　　　5 => '龙',
. f! H, o4 H  c3 S3 }　　　　　　　　6 => '蛇',
' p) `* r2 }! M/ {: f( h: K; ?1 |  T　　　　　　　　7 => '马',
　　　　　　　　8 => '羊',
8 R9 Z5 J6 m% w1 ^* Z  S1 @  r　　　　　　　　9 => '猴',
# F3 ?8 h/ K. W5 K% n9 G/ \　　　　　　　　10 => '鸡',
% O; g. y$ l4 B2 j8 Q　　　　　　　　11 => '狗',
2 T0 I  ]9 p0 A' |* ]% L0 O　　　　　　　　12 => '猪'
* a8 F& N: t8 R: G
0 Y( Q+ L8 A2 J# @1 v" v　　　　　性别：0 => '男',
' y! e" ]! d7 Z! J　　　　　　　　1 => '女'
; l6 y' O* x( A
(5).增加好友
$ \% U0 J/ E" X2 u　　提交数据：VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号
- T/ @$ E; a) l. P1 m1 b
　　返回：VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=0&UN=对方QQ号(允许被加为好友，此时他已经是你的好友)
" N6 O) f( D7 ~( M" R4 Z" y　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=1&UN=对方QQ号(需要验证)
! G' ~, X! _& Y, |  q5 U9 ]　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=2&UN=对方QQ号(决绝被加为好友)
0 o) H* I1 d: q' k! s2 _0 O, e　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、UN为字符)

(5).发送验证
　　说明：1、如果你加对方为好友，你需要发送验证
　　　　　2、对方加你为好友，发送了验证，你要通过或者拒绝
　　　　　这2种情况需要发送验证消息
) p9 h/ J  f) y" _
　　提交数据：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号&CD=验证类型&RS=理由
　　说明：CD为0表示“通过验证”，CD为1表示“拒决加为对方为好友”，CD为2表示“为请求对方加为好友”。
  L3 Y4 m' I# ^4 U& |) [
* r, a+ e. N" W7 Y$ i5 j　　返回：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=0(成功)
　　　　　VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=3(*)
. a( u1 @! \; g" t" F+ D" L. H; K　　　　　VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
+ j6 i5 r# a( F4 _" m8 j　　　　　NULL(UIN、UN、CD为字符，RS为非UTF-8字符)
　　*如果服务器返回RES=3，那么这次对话的响应时间在20s。当发送验证请求的时候，必须连发2次(请求内容不必一样)，其中一条RES=3，对方收不到，一条RES=0，对方能够收到。当CD>=3时，RES=3，响应时间20s。
8 D& K/ W$ v0 m% ?0 d  W  x
(6).删除好友
　　提交数据：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&UN=删除的QQ号

　　返回：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=0&(成功)
, o; y. d' F) n6 _+ Y' f" `　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=3(响应时间30s，重复发送的后果)
. t1 G  {% l4 W; Q& j1 \! A　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
7 N! g7 H4 }+ w$ L　　　　　NULL(UIN、UN为字符)
" S& F3 e* l: Q( e! w
' x# g$ z$ B  q7 G( d/ ^' s(7).改变状态
! ?, H9 A) N: D0 Q3 Z　　提交数据：VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&ST=状态代码
) B# k6 P" f1 x$ f　　说明：状态代码：10为上线，20为离线，30为忙碌，40为隐身，其他视为非法
# ?4 r/ p* ?/ h1 j- L8 A
  k, X' `' A. {% d9 U　　返回：VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=0&(成功)
& b8 K$ v4 r; Q. A　　　　　VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=3(失败，原因不明，响应时间20s，可能是过于频繁的改变状态引起的)
1 Z3 ~# O' q2 x* `; F# Q　　　　　VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN为字符，ST非法)
* N( k* ~6 u& E  X% S( Y0 `( N4 d
　　特别说明：如果你改变好友，将会给所有好友发送一条系统信息，内容就是状态代码；如果隐身，发送的状态代码为20，表示离线。
　　　　　　　同理，当你的好友改变状态，你也会收到一条系统信息。
. G' E6 `7 U# a4 }
' k3 S( ^* {' ~/ Z+ i! A, T(9).获得消息
　　提交数据：VER=1.1&CMD=GetMsgEx&SEQ=标记&UIN=QQ号

1 H3 v7 g1 h  i$ J0 K0 G& q　　返回：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的值用","分割，分别表示消息类型、发送人号码、消息内容)
' c$ r* D& k- Y" F$ i　　　　　VER=1.1&CMD=GETMSGEX&SEQ=标记&UIN=QQ号&RES=0&MN=0&MT=&UN=&MG=(表示没有信息)
; L% V% L4 t8 g& u7 ]　　　　　VER=1.1&CMD=GETMSGEX&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN为字符)
( C. i  B. k1 M' Y( `) o　　说明：关于MT：
' A1 o* A5 `# D3 p　　　　　　　9为用户消息，99为系统消息，2为请求信息，3为通过验证，4为拒绝被加好友
6 D& y" ^- h, `+ \" k　　　　　关于MG：
　　　　　　　当MT=9时，MG为用户发送的消息内容
　　　　　　　当MT=99时,
& Q) e, {, O' H) a　　　　　　　　　MG=10(QQ_STATUS_ONLINE)表示对方上线
' H! |( [8 Y& e: @! C( x  z  z+ i　　　　　　　　　MG=20(QQ_STATUS_OFFLINE)表示对方下线
　　　　　　　　　MG=30(QQ_STATUS_BUSY)表示对方进入忙碌状态
　　　　　　　当MT=2时，MG为对方请求你验证的信息
　　　　　　　当MT=3时，表示对方通过你的验证
　　　　　　　当MT=4时，MG为对方拒绝你理由
8 R7 }% F/ H: t" z! l/ I2 [
3 F0 P& @- q" Y- I6 c: y(10).发送消息
　　提交数据：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(发送过快)
　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
6 Z! h* J/ A: U& @# p　　　　　NULL(UIN、UN为字符，MG含非UTF-8字符)
　　说明：1、当你发消息时，以下情形对方可能看不到(其实是收到了，QQ不提示)你发送的消息：
. e, B. k# T8 C% ?, X& l( P  T3 {6 t　　　　　　　你俩互为陌生人，且对方没有和你说过话
; B3 q0 C" T  A6 M　　　　　　　你在他的陌生人列表里，并且他没有和你说过话(没有验证)
　　　　　2、当你过快发送消息时，系统会给你一个惩罚，RES=3，相应时间20s
　　　　　3、当我发送含有小写字母h的信息时，服务器有可能返回NULL

(11).登出
  k/ i! D- ]0 E- n; `　　提交数据：VER=1.1&CMD=Logout&SEQ=标记&UIN=QQ号
. c% X& v. T# N+ u# e: f
　　返回：VER=1.1&CMD=LOGOUT&SEQ=标记&UIN=QQ号&RES=0(成功，好像永远成功的，不管你是否登陆)
& Y0 p) l) q7 p& W9 e% M　　　　　NULL(UIN为字符)

５、总结

# B& b% u7 h. `- @+ n　　通过对照以上的接口说明，我开发出了能够实现基本QQ功能的PHP类，它整合了以上所有的接口，使用更方便，可以开发QQ机器人、群发广告程序等。免费获得类的代码请到
　　http://blog.hackfan.net/index.ph ... d=a_20050819_223558
8 ?) H' F3 `7 k　　本文撰写时间仓促，难免有误，希望各位不吝赐教
. ^' w. ?/ h, u, W9 l0 k

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