QQ的HTTP接口探究

天云上人

作者：Hackfan
" Q9 c1 @+ k3 c5 D, @/ W& j& [2 b日期：2005.8.21凌晨
联系：QQ:106814 Email:hackfan@vip.sina.com

１、研究说明

　　Tencent在tqq.tencent.com的8000有一个使用HTTP的QQ接口，通过这个接口，可以进行一些基本的操作，如：登陆、登出、改变登陆状态(上线、忙碌、离线、隐身)、添加删除好友、查看好友信息、发送验证信息(接受被加为好友、申请加对方为好友、拒绝被加为好友)、收发用户消息、系统信息。
0 M- S. U) e+ ~# E# L8 t
　　目前我研究的是1.1版本的HTTP QQ协议，研究是微程在的成果上进行的，不敢说有什么超越，只不过更为详细和准确。

２、接口说明：
/ _4 e  r' _; }( Z! l7 J. {
　　接口位置：tqq.tencent.com:8000
! }8 v2 v. F. k3 Y. x0 O) z) a& u　　通信协议：HTTP
1 o/ X# x  o( Y- c　　数据传输方法：POST
　　HTTP请求格式：

* b/ ?) t( y  i: M( T! q( iPOST HTTP/1.1
Host: tqq.tencent.com:8000
Content-Type: text/plain; charset=UTF-8
Content-length: 长度
Connection: close
9 X! j; K2 O0 ?+ c+ g/ \
数据

　　其中长度为 数据 的长度，数据的格式：
  }8 [0 \/ g" o. `4 X  j! v! ^　　VER=1.1&CMD=命令&SEQ=标记&UIN=QQ号&....

# N# b7 F; e6 d9 k0 K. h　　以上４个参数是每个请求都必有的。其中，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 z: L# ~( L; F& Q' |
３、研究方法：

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

1. <?
   9 M) W: ^& D6 G( _7 }
2. $uin = "QQ号";
   
3. $pwd = md5("QQ密码");
   / K  n- t( m3 A
4. 
   7 A& y- p( g5 j
5. //登陆测试
   
6. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=1&LC=9326B87B234E7235";
   / w8 z# a8 L1 J) q9 C9 R0 u* ^
7. //注意：登陆测试不能同时进行，必须等到服务器认为QQ断开了，才能够测试，不然结果不可信
   
8. /*******
   ( @) Q# f7 V# n% y( d5 Y& O
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";
    3 _* r' S3 G, {5 g! H2 T
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";
    5 s2 `& G3 w: V$ d: u$ h, B
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. *******/
    % {' L" b$ j9 T( z
16. 
    
17. 
    
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";
    , h1 F# h0 J* M1 L1 T
22. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=0";
    , {5 t/ b2 I5 B  e
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";
    . {0 r- v  y' ?. L, N
26. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    + n$ U3 u& B1 N- d
27. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    + ]; X0 t* T" o, M
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";
    2 I4 s% i+ I5 F; _9 I! d- i3 h% U
30. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    3 _8 Z" F% z1 V* C2 Q3 o  M
31. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    $ X( q( ~9 @& ?2 e6 d6 x: u
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;
    
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";
    : i! o. @& u7 E% L& c8 G
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);
    
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";
    ) ?( u& l& ~/ Q1 a; J( _- \
45. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
      A% Q( \' S+ i0 [( @, n1 T
46. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    ! n/ V& n. X4 h  G7 H
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";
    
51. 
    / P. ?* }) I8 H/ n8 P
52. //查看好友信息
    
53. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=0&UN=106814";
    : s8 K' w4 {2 @& Q/ U& K
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. //增加好友
    
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";
    8 P- I" j2 }- K5 l' V6 Y: u4 L
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";
    * P. a9 X1 q7 l* `  ?5 p# x
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";
    
69. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=5&RS=TEST";
    0 \5 w9 L# j9 m- ]
70. 
    
71. //删除好友
    0 c  d; n0 `7 Y2 l
72. $poststring[] = "VER=1.1&CMD=DelFromList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814";
    : D) Y! d% T" E2 T0 o
73. 
    6 |5 S' |3 p/ K  r. ^
74. //改变状态
    % |/ Y  Q; j( c9 |. l. \0 B4 R
75. for($i=0;$i<=60;$i=$i+5)
    ! s5 f% {6 _) |+ ]; o
76. {
    % V# b: t/ ?" Z1 v7 p1 A$ @
77. $poststring[] = "VER=1.1&CMD=Change_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&ST=".$i;
    ( i& H, z2 k& }7 o5 I, q5 E
78. }
    
79. 
    0 e- h  f; B  ~, M
80. //获得消息
    - ^$ @* w7 h; n( N
81. $poststring[] = "VER=1.1&CMD=GetMsgEx&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    3 w8 z6 y5 u4 R) P
82. 
    ' p* |0 D" z0 Q% j; R# i: {+ E
83. //发送消息
    
84. $poststring[] = "VER=1.1&CMD=CLTMSG&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&MG=TEST";
    
85. 
    / A" z# K- G0 Q( m
86. //登出
    
87. $poststring[] = "VER=1.1&CMD=Logout&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    
88. 
    ) f' M$ i6 d0 A, ^# M+ X: ~
89. $file = fopen("p.txt","w");
    
90. 
    $ T% {) Z8 }5 H9 Q/ M
91. foreach($poststring as $k=>$v)
    
92. {
    
93. ss_timing_start();
    
94. $fp = fsockopen('tqq.tencent.com', '8000', $errno, $errstr, $timeout = 10);  
    
95. 
    
96. if(!$fp){  
    
97. //error tell us  
    
98. $content = $k.chr(13).chr(10)."ERROR:$errstr ($errno)";  
    1 _% T1 }- {8 _* p2 N
99.    
    
100. }else{  
     
101. 
     + N3 b3 P2 u2 w4 J
102.   //send the server request  
     
103.   fputs($fp, "POST HTTP/1.1\r\n");  
     $ u' y9 o$ X1 s3 k& b
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");  
     8 u: s+ f5 Y# s! B
109. 
     
110.   //loop through the response from the server  
     
111.   $res = "";
     
112.   while(!feof($fp)) {  
     : Q- ?# b' b+ O# x" h5 A- y
113.   $res .= fgets($fp, 4096);  
     
114.   }  
     % m* w0 O; h% ~& b% |
115.   //close fp - we are done with it  
     
116.   fclose($fp);  
     
117. 
     
118.   $content = $v.chr(13).chr(10).$res;
     
119. }  
     
120. ss_timing_stop();  
     . o0 f7 u* \) }: D* B
121. $content .= chr(13).chr(10)."Time: ".ss_timing_current().chr(13).chr(10)."--------------------------------------".chr(13).chr(10);
     ) n' ~, g' b7 g' n& s
122. fputs($file,$content);
     & B' r" }" \9 `1 z) ?
123. }
     0 m! J% q) R2 {0 a* j
124. fclose($file);
     
125. ?>
     
126. <?
     
127. function ss_timing_start ($name = "default") {  
     4 a. e* W8 H. @' Y: R( y
128. global $ss_timing_start_times;  
     
129. $ss_timing_start_times[$name] = explode(' ', microtime());  
     ; a# ^+ k3 f8 m$ A8 ?. e
130. }  
     3 N% o( A  l4 X  Y& H
131. function ss_timing_stop ($name = "default") {  
     
132. global $ss_timing_stop_times;  
     . X; M$ T: D$ @* P/ N5 b
133. $ss_timing_stop_times[$name] = explode(' ', microtime());  
     & o- W( ~- \4 o0 Y2 G$ b2 T4 W
134. }  
     / E# I/ v) Q, L* E3 r: C
135. function ss_timing_current ($name = "default") {  
     2 b: E: }2 ?$ _* A1 y4 k9 `& S) n
136. global $ss_timing_start_times, $ss_timing_stop_times;  
     
137. if (!isset($ss_timing_start_times[$name])) {  
     
138. return 0;  
     8 a1 ?4 p2 h  j+ d  x; A/ P
139. }  
     : }8 g& @' C9 n" K- S6 m& V2 K
140. if (!isset($ss_timing_stop_times[$name])) {  
     
141. $stop_time = explode(' ', microtime());  
     . \/ {2 w( l% Q3 B7 v3 ?: Z
142. }  
     1 A5 ~2 L" c) {  a
143. else {  
     9 g! u" J. N2 I; ]9 P* o
144. $stop_time = $ss_timing_stop_times[$name];  
     / x. z) ~7 v6 i6 U
145. }  
     ' z8 j  u% J. V
146. $current  =  $stop_time[1]-$ss_timing_start_times[$name][1];  
     
147. $current += $stop_time[0]-$ss_timing_start_times[$name][0];  
     6 c" m9 M, \7 Y: h
148. return $current;  
     
149. }  
     
150. ?>

复制代码

; R; g9 k" q: _) c  |8 i: N7 c4 F5 U４、研究成果：
, ]1 u1 n' C0 W7 Y3 q
(1).登陆
　　说明：在你做任何其他操作以前，你必须登陆。只有在登陆以后，你的其他指令才有可能被正确执行(返回RES=0)，不然服务器会返回RES= 20，不过有个例外，就是logout。当你成功登陆以后，服务器就会根据你的IP*和参数中的UIN来验证身份。一台电脑可以同时登陆多个QQ，互不影响，就是因为有参数UIN。
  O  e4 ?, |& b　　*至于我能够确定服务器是通过IP来验证的，是因为服务器不可能通过我的请求获得其他信息了^_^
# o, p8 l" C" W/ y1 |
( k$ k6 ~7 R' C9 [; |# q　　提交数据：VER=1.1&CMD=Login&SEQ=标记&UIN=QQ号&PS=QQ密码&M5=1&LC=9326B87B234E7235
" ^: [7 \7 z" R1 }& O1 Y5 x) ^) ~　　说明：QQ密码是通过md5加密的字符串，在PHP中可以直接用md5()进行加密；
　　　　　M5这个参数的作用还不清楚，但最好为1。
! H& j- r" M% }' u9 q1 w, t　　　　　LC这个参数有点神秘，不能有丝毫改动，不然服务器就没有响应(没有响应就是返回NULL)。

0 l& R- U* p" K* ]) o( A　　返回：VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=0&RS=0&HI=60&LI=300(成功)
  j, x+ R0 ~: M# j　　　　　VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=0&RS=1&RA=密码错误(密码错误)
8 p! F7 ]4 I( M, k0 w  l0 M　　　　　VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=5(QQ号非法，如100)
1 q$ `1 P" \3 S　　　　　NULL(UIN为字符、PS为空、LC错误)

(2).得到好友列表
　　提交数据：VER=1.1&CMD=List&SEQ=标记&UIN=QQ号&TN=160&UN=0
　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响

: b2 S/ u! \5 x/ 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为好友列表，用","分割)
　　　　　VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
* |7 ~% q  V1 D3 X+ n% s" ~　　　　　NULL(UIN、TN、UN为字符)

(3).得到在线好友列表
　　提交数据：VER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号&TN=50&UN=0
6 |1 w' ]3 H* b0 ]: |　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响
+ a0 i% J! ~! f2 N3 m' [
　　返回：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(没有正确登陆)
! j% _5 c' N6 x( n+ e* N　　　　　NULL(UIN、TN、UN为字符)
$ k8 p# J0 H& e) |" n7 s　　说明：FC为QQ头像的的ID，如的头像ID为270，那么其头使用的图片为91.bmp,其算法为ID/3+1；
" J2 i- |* G2 M5 U  z+ @, f. @　　　　　ST为QQ用户的状态，10为上线，20为离线(或隐身)，30为忙碌；
# |% ]3 x, _. z
　　特别说明：当参数TN=0或不存在时，服务器返回：
- ]8 w; b! [1 S5 g- {$ |$ h4 ~8 tVER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号
HTTP/1.1 200 OK
Server: tencent imserver/1.0.0
Content-Type: text/plain; charset=UTF-8
0 B9 {$ v) D8 f) a$ CContent-Length: 56

4 T; T# V$ B) }/ V3 R. t7 Z8 l) D2 XVER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FN=1
HTTP/1.1 200 OK
Server: tencent imserver/1.0.0
Content-Type: text/plain; charset=UTF-8
. S) C" \1 H& `5 l# A7 YContent-Length: 77

; s  c+ d+ z# `VER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FC=&FN=1&SN=0&ST=&UN=&NK=
　　返回了２次，第一次的结果中，FN为在线好友数，第二次返回的数据基本没用。
8 @( _1 |1 y% ^7 T. N& R
(4).查看好友信息
　　提交数据：VER=1.1&CMD=GetInfo&SEQ=标记&UIN=QQ号&LV=查询类型&UN=被查询QQ号码
3 U, c5 k: p: ]5 A+ U　　说明：LV=0,1为精简查询，LV=2为普通查询，LV>=3为详细查询
5 ^2 Q! o. @! Q# S; P& K
5 A$ u4 v6 F, b( N3 f- s4 p　　返回：VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=0&LV=0&UN=106814&NK=Hackfan 好(精简查询)
3 A: ?) j0 S. T  f　　　　　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=学生
! W' R( v# w% c&LV=2&PC=邮编&PH=电话&PR= The guy is updating to .NET Frameword......&PV=江苏&RN=胡吉阳&SC= 毕业院校&SX=0&UN=106814&NK=Hackfan  
好(普通查询)
　　　　　VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=0&AD =地址&AG=19&BT=2&CO=6&CT=苏州&CV=%01&CY=中华人民共和国
5 `9 {! U7 G3 i: h' u&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(没有正确登陆)
　　　　　NULL(UIN、LV、UN为字符)
! H, o" ]: B# N) i
　　说明：AD为联系地址
7 s$ V) d4 r$ i) V2 y1 x5 C　　　　　AG为年龄
　　　　　BT为血型
　　　　　CO为星座
4 g& o' w7 @% A: O& W　　　　　CT为城市
　　　　　CV为未知*
　　　　　CY为国家
$ e* k* O, e1 p　　　　　EM为Email
　　　　　FC为头像
# k) i4 K* C9 }7 L6 d% J. M, J　　　　　HP为网站
　　　　　ID为未知
　　　　　JB为职业
　　　　　LV为查询代码(就是发送的LV)
" f& e% J3 A' H: d+ {　　　　　MO为移动电话
　　　　　MT为未知
% t3 u; V8 y$ M" ]! [　　　　　MV为未知
; v/ H0 l, u2 h' T/ `" I. W! w　　　　　PC为邮编
　　　　　PH为联系电话
( w; Y5 O6 N) X/ w- T: e. K9 d　　　　　PR为简介
　　　　　PV为省
　　　　　RN为真实姓名
　　　　　SC为毕业院校
1 i: x# P  i; g0 j. N　　　　　SH为生肖
　　　　　SX为性别
　　　　　UN为QQ号
* h! s0 D3 p9 r) f$ p5 m. S+ M　　　　　NK为昵称

* |1 X) C7 e: a4 I  B- W$ T" I　　　　　血型：0 => '',
　　　　　　　　1 => 'A型',
  d5 S9 I) |2 ?  G　　　　　　　　2 => 'B型',
5 D# b" L. I* r4 s9 J  F: s& U　　　　　　　　3 => 'O型',
6 Z% O- s# ?) M3 g" W0 @　　　　　　　　4 => 'AB型',
　　　　　　　　5 => '其他'

6 B( h% S$ e! q6 {9 X5 H
　　　　　星座：0 => '',
, O" n6 w9 D5 ]　　　　　　　　1 => '水瓶座',
8 r# p) I$ H% J9 C, G9 k　　　　　　　　2 => '双鱼座',
　　　　　　　　3 => '牡羊座',
8 j. `/ p  ^. f6 t　　　　　　　　4 => '金牛座',
/ _0 t3 J$ O* i9 [$ x" I0 [　　　　　　　　5 => '双子座',
) Q) O" q# X2 D( F" h, E1 h, U6 Q　　　　　　　　6 => '巨蟹座',
$ B1 F$ v& d' M- L5 |# P9 a　　　　　　　　7 => '狮子座',
　　　　　　　　8 => '座',
3 P' T/ q! C2 u# h! P　　　　　　　　9 => '天秤座',
7 w0 p$ T/ x: T' ~( {　　　　　　　　10 => '天蝎座',
　　　　　　　　11 => '射手座',
3 W* @2 N# _0 `- B8 w. X　　　　　　　　12 => '摩羯座'

9 E' a9 h: H4 s# [　　　　　生肖：0 => '',
: M& T9 l- h7 `* i( \3 E* R　　　　　　　　1 => '鼠',
　　　　　　　　2 => '牛',
) S/ @9 K  Z6 B) p  y3 M  o9 L　　　　　　　　3 => '虎',
　　　　　　　　4 => '兔',
; m2 Q/ }# b  P( k! P　　　　　　　　5 => '龙',
　　　　　　　　6 => '蛇',
7 l0 I) b) g; D- k7 j　　　　　　　　7 => '马',
  L. G9 C& s" D3 v6 v- \4 C　　　　　　　　8 => '羊',
　　　　　　　　9 => '猴',
+ a: G9 j) w; [) K7 Z: f9 v# C( S; w　　　　　　　　10 => '鸡',
　　　　　　　　11 => '狗',
8 b6 H- U: \1 E) Z" {% q6 s2 v' b, F1 y　　　　　　　　12 => '猪'
' L) i, ^8 D$ ]9 r- _
1 f: m8 Q: Z* d" U: |　　　　　性别：0 => '男',
5 Z( {8 ~$ V: Q6 v) l5 I6 h　　　　　　　　1 => '女'
1 ?9 f4 v7 Y. P1 ^! [/ q
(5).增加好友
　　提交数据：VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号
) D2 Q, A, E% F
4 g# `+ F; u" g　　返回：VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=0&UN=对方QQ号(允许被加为好友，此时他已经是你的好友)
0 E1 B6 a/ c! s　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=1&UN=对方QQ号(需要验证)
$ F, C" n* G+ ~- g  U5 P: v　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=2&UN=对方QQ号(决绝被加为好友)
　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
0 r% j+ r4 |& T' {0 N　　　　　NULL(UIN、UN为字符)

(5).发送验证
1 ?0 o7 E- {3 X6 l  M　　说明：1、如果你加对方为好友，你需要发送验证
　　　　　2、对方加你为好友，发送了验证，你要通过或者拒绝
$ k  h+ Q' s! {4 o# L- f　　　　　这2种情况需要发送验证消息

6 G# i8 ?' c1 p' Z　　提交数据：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号&CD=验证类型&RS=理由
　　说明：CD为0表示“通过验证”，CD为1表示“拒决加为对方为好友”，CD为2表示“为请求对方加为好友”。
( r; T9 ~2 `6 R8 K" }
3 ]) N% L- u; _+ ]% L　　返回：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=0(成功)
5 X  h* x# D# Y1 s% C% D1 R2 b　　　　　VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=3(*)
3 N0 P& @: A# B% n) o　　　　　VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
! A: O" h0 d, ]+ R. N4 w% p　　　　　NULL(UIN、UN、CD为字符，RS为非UTF-8字符)
6 K/ ?' \5 c' D　　*如果服务器返回RES=3，那么这次对话的响应时间在20s。当发送验证请求的时候，必须连发2次(请求内容不必一样)，其中一条RES=3，对方收不到，一条RES=0，对方能够收到。当CD>=3时，RES=3，响应时间20s。
0 u, K9 N! ?9 w9 s% M
4 ~: P* @6 g, K, H9 T! S(6).删除好友
　　提交数据：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&UN=删除的QQ号

　　返回：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(没有正确登陆)
8 `  g2 f2 H1 i, w　　　　　NULL(UIN、UN为字符)
6 I1 T& O  ~, W  @* k" G
(7).改变状态
# K& w: e' Z; I1 A( o　　提交数据：VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&ST=状态代码
; e9 c% a6 P8 s; e, E1 P　　说明：状态代码：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，可能是过于频繁的改变状态引起的)
9 \$ _- T% E; C8 D( T- N1 f　　　　　VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN为字符，ST非法)

　　特别说明：如果你改变好友，将会给所有好友发送一条系统信息，内容就是状态代码；如果隐身，发送的状态代码为20，表示离线。
4 n. s+ z( @: _3 P2 Q, N# |　　　　　　　同理，当你的好友改变状态，你也会收到一条系统信息。

' i/ ^2 ^! g" J! t2 E(9).获得消息
+ r) ?/ @0 s: q1 m- u　　提交数据：VER=1.1&CMD=GetMsgEx&SEQ=标记&UIN=QQ号

' d" X5 s  I* u9 C　　返回：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=(表示没有信息)
2 s3 c: L9 o5 K4 s; L5 Q8 b　　　　　VER=1.1&CMD=GETMSGEX&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN为字符)
; A1 p, E# k' Z  k1 m% W+ `　　说明：关于MT：
" j% r% P" ~2 b! l　　　　　　　9为用户消息，99为系统消息，2为请求信息，3为通过验证，4为拒绝被加好友
* Q5 p* d% ?* I　　　　　关于MG：
　　　　　　　当MT=9时，MG为用户发送的消息内容
　　　　　　　当MT=99时,
　　　　　　　　　MG=10(QQ_STATUS_ONLINE)表示对方上线
　　　　　　　　　MG=20(QQ_STATUS_OFFLINE)表示对方下线
# \) G+ j: A. z, n. r( t　　　　　　　　　MG=30(QQ_STATUS_BUSY)表示对方进入忙碌状态
9 s9 f: W. L, P! Q+ |　　　　　　　当MT=2时，MG为对方请求你验证的信息
, A3 K; G% w, @; m' i) `$ p/ A3 U　　　　　　　当MT=3时，表示对方通过你的验证
　　　　　　　当MT=4时，MG为对方拒绝你理由

7 r( r/ Y1 c) k(10).发送消息
& g* S5 A+ f1 e" L1 [　　提交数据：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&UN=对方QQ号&MG=发送内容
& F7 z6 g+ s' R8 W& }
　　返回：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=0&(成功发送，对方不一定能收到哦)
1 w7 \7 L! i. Q& o7 J9 F, c' j　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=3(发送过快)
9 n5 `1 S3 e2 m　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、UN为字符，MG含非UTF-8字符)
　　说明：1、当你发消息时，以下情形对方可能看不到(其实是收到了，QQ不提示)你发送的消息：
　　　　　　　你俩互为陌生人，且对方没有和你说过话
" }" g& O5 M$ B" ]+ r　　　　　　　你在他的陌生人列表里，并且他没有和你说过话(没有验证)
　　　　　2、当你过快发送消息时，系统会给你一个惩罚，RES=3，相应时间20s
2 O. Q' \* h$ i1 }" f: h　　　　　3、当我发送含有小写字母h的信息时，服务器有可能返回NULL

(11).登出
# @5 h  q6 J$ l. Y% ]" n& }9 \# u　　提交数据：VER=1.1&CMD=Logout&SEQ=标记&UIN=QQ号

　　返回：VER=1.1&CMD=LOGOUT&SEQ=标记&UIN=QQ号&RES=0(成功，好像永远成功的，不管你是否登陆)
3 Q* k9 c  o, i0 V4 A0 q' `　　　　　NULL(UIN为字符)
3 D+ b5 x0 C1 h+ o8 k
５、总结

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


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