QQ的HTTP接口探究

天云上人

作者：Hackfan
日期：2005.8.21凌晨
联系：QQ:106814 Email:hackfan@vip.sina.com

* B0 _1 k7 {5 d& O$ O１、研究说明

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

　　目前我研究的是1.1版本的HTTP QQ协议，研究是微程在的成果上进行的，不敢说有什么超越，只不过更为详细和准确。
7 F8 j6 L! h; U) I4 A: a8 h
２、接口说明：
+ i% X: V) M5 d6 E! q' b; L  v  G
　　接口位置：tqq.tencent.com:8000
- S9 r' B. @0 p6 _& y3 h　　通信协议：HTTP
　　数据传输方法：POST
, M- G2 J; }. @' t3 z　　HTTP请求格式：
' s- S9 P5 R6 V2 k1 Y
) N5 o; J9 S5 }: X. ]: S2 hPOST HTTP/1.1
Host: tqq.tencent.com:8000
: d7 A$ B* K, R. y$ [, E8 yContent-Type: text/plain; charset=UTF-8
Content-length: 长度
Connection: close
- b0 Q+ L4 u' o5 [& O2 K( c
, C  L6 l: K5 G8 b2 s' U数据
- a' i- K! s: Z6 F% b
2 ^) s  C" M+ K  v! l% g4 U) C: e5 l　　其中长度为 数据 的长度，数据的格式：
　　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还需要不同的参数，下面我就公布我的研究成果。
8 q4 ^1 Z6 F: p; _; C% l" `
  }: Q+ u- h* Q) R* b$ L6 M4 Z' v３、研究方法：
' L" _2 U% z, f1 F2 B- [6 i
  z6 v6 D+ |+ v$ r0 C　　我对目前网上的资料不够满意，就自己写程序，发送多条相同CMD不同参数的请求，根据服务器的返回，来做判断。感兴趣的朋友可以参考一下，此处可以跳过。
' l, i+ h; x5 v. Q0 f　　下面我公布我探测的代码(PHP)：

1. <?
   + J) e5 C( p& t. b
2. $uin = "QQ号";
   ! ~, S7 t4 c# K! s0 q, |
3. $pwd = md5("QQ密码");
   - L/ U3 O4 T3 n& M
4. 
   
5. //登陆测试
   
6. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=1&LC=9326B87B234E7235";
   # M8 K7 X5 r9 S2 {4 X, n+ Q/ l
7. //注意：登陆测试不能同时进行，必须等到服务器认为QQ断开了，才能够测试，不然结果不可信
   
8. /*******
     \% x( w0 E3 z1 y
9. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=0&LC=9326B87B234E7235";
   # t: F, f6 S4 q' k' X* n4 p
10. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=1&LC=9326B87B234E7235";
    1 ^# u, }4 n1 |; P, W
11. $poststring[] = "VER=1.1&CMD=Login&SEQ=".rand(1000,9000)."&UIN=".$uin."&PS=".$pwd."&M5=2&LC=9326B87B234E7235";
    8 j8 w: g/ p4 s4 {5 b3 d5 {0 T
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";
    5 S/ ?9 A: D' N+ g
15. *******/
    
16. 
    
17. 
    
18. //得到好友列表
    
19. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin;
    0 H  }5 V# {$ o
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";
    
22. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=0";
    / x$ e% Q- f  }" b. \
23. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=".rand(1,10);
    : [! X  N$ Z7 I7 I! `
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";
    9 J1 o* c( }. J9 L6 H4 b
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";
    . P: e% R; P3 _8 D& o# ]' y
29. $poststring[] = "VER=1.1&CMD=List&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    % |! C4 t. M! {  e
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";
    
34. 
    ; G; n' K1 V  M4 E
35. //得到在线列表
    7 \$ w0 o# d" \8 K" y- l+ f
36. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin;
    ; ~- @* I, X. t9 J  I
37. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0";
    7 ^7 L; R! |- N  O3 ?& O/ F5 z- C
38. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160";
    ; ^& v0 @& U+ ~7 m
39. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=0";
    5 I) ?' Y7 p6 z# G
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";
    - f0 _' g9 I) k9 m" R( ^' i
42. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    8 P5 ~; B- m: O0 o9 |2 ~6 p4 F/ ?* F
43. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=160&UN=0";
    - A$ N7 F+ n6 a. C( U( p
44. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    " c  ^' g6 [; g4 s+ V0 ]
45. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=".rand(1,200)."&UN=0";
    % p5 k1 y0 j3 \  d0 C. f3 x( w
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);
    
48. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    ; O/ D( P7 `$ W# t1 ]3 V! N; F
49. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=".rand(1,10);
    + {& M  X8 K' }! |' D
50. $poststring[] = "VER=1.1&CMD=Query_Stat&SEQ=".rand(1000,9000)."&UIN=".$uin."&TN=0&UN=106814";
    9 O# _- t* B$ k( r" j) H
51. 
    , e) h, V4 p0 V7 r* G
52. //查看好友信息
    
53. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=0&UN=106814";
    ! w" a2 u6 ?- u- l
54. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=1&UN=106814";
    5 r9 L0 j. [1 W
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";
    9 Z) [9 V3 |9 Q; H; m+ U: n, E- B
58. $poststring[] = "VER=1.1&CMD=GetInfo&SEQ=".rand(1000,9000)."&UIN=".$uin."&LV=5&UN=106814";
    # \9 q# H* \9 S, a
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";
    
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";
    
68. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=4&RS=TEST";
    1 {( O2 V" Y2 O0 f% c) R" Z
69. $poststring[] = "VER=1.1&CMD=Ack_AddToList&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&CD=5&RS=TEST";
    6 P) `2 T3 X. F+ M
70. 
    6 K1 H, o5 d" _- m
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. }
    3 |% o# ?9 `7 t# K7 V
79. 
    6 F) ?( q* ?( K3 B
80. //获得消息
    
81. $poststring[] = "VER=1.1&CMD=GetMsgEx&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    - T" I" j* \; I; n) v
82. 
    
83. //发送消息
    % @8 ?) n) I1 Z' N, m& d& c- f! x
84. $poststring[] = "VER=1.1&CMD=CLTMSG&SEQ=".rand(1000,9000)."&UIN=".$uin."&UN=106814&MG=TEST";
    
85. 
    
86. //登出
    9 J6 i: q. U: z: d- \
87. $poststring[] = "VER=1.1&CMD=Logout&SEQ=".rand(1000,9000)."&UIN=".$uin."";
    
88. 
    
89. $file = fopen("p.txt","w");
    
90. 
    
91. foreach($poststring as $k=>$v)
    + j9 \+ w5 v8 ~9 h
92. {
    
93. ss_timing_start();
    & E7 i0 a3 g6 Z: f! Y4 p
94. $fp = fsockopen('tqq.tencent.com', '8000', $errno, $errstr, $timeout = 10);  
    
95. 
    ! k4 K/ }0 ~, K) Q4 c$ C) U
96. if(!$fp){  
    
97. //error tell us  
    / l  H$ v$ w. j; m( P
98. $content = $k.chr(13).chr(10)."ERROR:$errstr ($errno)";  
    + v2 X/ |  T  @1 [" y  }. d2 L. d: {9 F
99.    
    
100. }else{  
     
101. 
     
102.   //send the server request  
       Y3 ~0 G" m" r4 x  o1 M0 X
103.   fputs($fp, "POST HTTP/1.1\r\n");  
     
104. //  fputs($fp, "Host: $host\r\n");  
     9 n* \2 W! [3 ~3 K; Y( N0 ?
105. //  fputs($fp, "Content-type: application/x-www-form-urlencoded\r\n");  
     ( X" {; U+ ?1 M+ p
106.   fputs($fp, "Content-length: ".strlen($v)."\r\n");  
     * \( l# P4 m+ V/ I4 V' S
107.   fputs($fp, "Connection: close\r\n\r\n");  
     9 H5 u& w7 `  {" _2 V
108.   fputs($fp, $v . "\r\n\r\n");  
     
109. 
     % p& K$ y6 X# B& k% E4 n
110.   //loop through the response from the server  
     
111.   $res = "";
     
112.   while(!feof($fp)) {  
     
113.   $res .= fgets($fp, 4096);  
     
114.   }  
     
115.   //close fp - we are done with it  
     
116.   fclose($fp);  
     
117. 
     " m0 J) r( z# @) v
118.   $content = $v.chr(13).chr(10).$res;
     : J2 q. f; B6 y4 w9 F( o) R- L
119. }  
     % F( Z/ i# S/ P
120. ss_timing_stop();  
     
121. $content .= chr(13).chr(10)."Time: ".ss_timing_current().chr(13).chr(10)."--------------------------------------".chr(13).chr(10);
     
122. fputs($file,$content);
     5 ], m  c8 m0 ~8 y( O; W+ M
123. }
     
124. fclose($file);
     
125. ?>
     
126. <?
     4 o3 G6 ~0 B' F6 _2 Q' j
127. function ss_timing_start ($name = "default") {  
     " S. U( D; @2 d( j- s
128. global $ss_timing_start_times;  
     
129. $ss_timing_start_times[$name] = explode(' ', microtime());  
     
130. }  
     0 z1 f' R" U+ b/ Y
131. function ss_timing_stop ($name = "default") {  
     7 e5 E/ v: M5 Y+ G, Y7 }& N: m# N
132. global $ss_timing_stop_times;  
     , E  t+ c# B/ H  }1 c; h
133. $ss_timing_stop_times[$name] = explode(' ', microtime());  
     : d. h+ B1 g  f$ ]9 D4 O1 O+ @
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])) {  
     1 a5 e5 i  S3 F- `$ X- m
138. return 0;  
     & D$ Q+ N' b0 r- x5 e5 f
139. }  
     * p: V& w, y" g' f; G5 d
140. if (!isset($ss_timing_stop_times[$name])) {  
     ) ^) e% l. @* ?1 }. W
141. $stop_time = explode(' ', microtime());  
     
142. }  
     * Y" t6 H1 M0 S) u  i0 g) H. W
143. else {  
     ) `" v& z& p7 F+ d! d' i- E
144. $stop_time = $ss_timing_stop_times[$name];  
     : }( d3 I6 U5 }; y
145. }  
     ; A, C$ m+ r" P) C
146. $current  =  $stop_time[1]-$ss_timing_start_times[$name][1];  
     . s( r- o; {7 D+ I* V" o2 p
147. $current += $stop_time[0]-$ss_timing_start_times[$name][0];  
     / v4 u  K" `- b
148. return $current;  
     
149. }  
     % k+ l! }" a5 y$ L
150. ?>

复制代码

6 O  y  y5 C* h: z４、研究成果：
  g6 X& C( ^) k
1 z. R. \  ]( F; a6 ~! w( k7 ?8 x* a(1).登陆
　　说明：在你做任何其他操作以前，你必须登陆。只有在登陆以后，你的其他指令才有可能被正确执行(返回RES=0)，不然服务器会返回RES= 20，不过有个例外，就是logout。当你成功登陆以后，服务器就会根据你的IP*和参数中的UIN来验证身份。一台电脑可以同时登陆多个QQ，互不影响，就是因为有参数UIN。
5 x! _, m4 ?- _8 A- g　　*至于我能够确定服务器是通过IP来验证的，是因为服务器不可能通过我的请求获得其他信息了^_^
6 L4 U9 a9 K& d& E4 d: ^5 P+ }' D+ F
4 x0 E8 [1 ^1 J7 S　　提交数据：VER=1.1&CMD=Login&SEQ=标记&UIN=QQ号&PS=QQ密码&M5=1&LC=9326B87B234E7235
! K4 k8 J& K3 t6 I* v! _5 X" Y2 [2 B1 R　　说明：QQ密码是通过md5加密的字符串，在PHP中可以直接用md5()进行加密；
　　　　　M5这个参数的作用还不清楚，但最好为1。
9 |; E$ u7 S# m" v: u( @　　　　　LC这个参数有点神秘，不能有丝毫改动，不然服务器就没有响应(没有响应就是返回NULL)。

　　返回：VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=0&RS=0&HI=60&LI=300(成功)
2 b+ W7 n4 s8 W) @" _　　　　　VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=0&RS=1&RA=密码错误(密码错误)
# d) M( R" h% w; u2 Y1 T4 B% ?　　　　　VER=1.1&CMD=LOGIN&SEQ=标记&UIN=QQ号&RES=5(QQ号非法，如100)
, W8 K0 w* c9 e4 G& B6 ?: e8 r　　　　　NULL(UIN为字符、PS为空、LC错误)

(2).得到好友列表
　　提交数据：VER=1.1&CMD=List&SEQ=标记&UIN=QQ号&TN=160&UN=0
　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响
" y' D) i/ h/ f$ U) S, p
0 g) S5 c8 \& u3 W& U: {/ T8 J　　返回：VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=0&FN=9(当TN=0或没有TN参数时，FN表示好友数)
" q( Y. Q) }4 H9 Y& G) ]1 `　　　　　VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=0&FN= 1&SN=9&UN=3814526,...,(当TN存在且非0时，FN=1，SN表示好友数，UN为好友列表，用","分割)
' p# H% w5 G. }  q+ q0 H" n　　　　　VER=1.1&CMD=LIST&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、TN、UN为字符)

5 Q& f0 u- E. i8 \(3).得到在线好友列表
　　提交数据：VER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号&TN=50&UN=0
　　说明：TN、UN还不清楚具体表示什么，但是TN的值会影响返回的结果，有没有UN对结果没有影响
8 ?" }; I4 r. D+ h' I
! W; t; Z8 I& A% T　　返回：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为字符)
$ @* ~4 G0 t5 K+ k8 O& f' ~! Q- x! G　　说明：FC为QQ头像的的ID，如的头像ID为270，那么其头使用的图片为91.bmp,其算法为ID/3+1；
: \$ _& g8 e. ]8 y8 e0 H　　　　　ST为QQ用户的状态，10为上线，20为离线(或隐身)，30为忙碌；

　　特别说明：当参数TN=0或不存在时，服务器返回：
/ b1 }" w% o  ?) EVER=1.1&CMD=Query_Stat&SEQ=标记&UIN=QQ号
HTTP/1.1 200 OK
) M- q; ]4 j; E( e" GServer: tencent imserver/1.0.0
Content-Type: text/plain; charset=UTF-8
Content-Length: 56

5 v5 x1 b" }' Q5 Z4 L1 |' DVER=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
Content-Length: 77

" I* c7 p' m- ~. x" ~1 z  b: n( h" {% WVER=1.1&CMD=QUERY_STAT&SEQ=标记&UIN=QQ号&RES=0&FC=&FN=1&SN=0&ST=&UN=&NK=
; \7 a# L8 W0 \7 ^( r" C* C. H　　返回了２次，第一次的结果中，FN为在线好友数，第二次返回的数据基本没用。
( m8 l9 p) [) O' Y0 j1 A
(4).查看好友信息
7 `# n& A" _* x" {, ^8 w+ W　　提交数据：VER=1.1&CMD=GetInfo&SEQ=标记&UIN=QQ号&LV=查询类型&UN=被查询QQ号码
; K" s  f2 F5 B. Z　　说明：LV=0,1为精简查询，LV=2为普通查询，LV>=3为详细查询

# H( x$ T* t+ H3 H　　返回：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  
7 t" u- K+ z( r# K/ z: b/ k  e0 V1 s好(普通查询)
9 y9 g9 N& w" X　　　　　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 好(详细查询)
8 g9 `8 p7 h: A( n8 W! h1 Q　　　　　VER=1.1&CMD=GETINFO&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、LV、UN为字符)
$ o' R4 p$ @% H5 [6 c. ~, m( ^
0 P6 w% ?$ y5 D6 t: X: ?　　说明：AD为联系地址
　　　　　AG为年龄
0 h# U8 Q2 b* l( |! S( j4 ~　　　　　BT为血型
　　　　　CO为星座
4 D( ]" q, X( l/ b( g2 n' `　　　　　CT为城市
　　　　　CV为未知*
. i6 _! i6 `' ~　　　　　CY为国家
* S% Z4 q% p) X/ Z' ?7 w　　　　　EM为Email
　　　　　FC为头像
　　　　　HP为网站
9 G; `1 _! m9 H7 F* E2 l; _! T/ z　　　　　ID为未知
　　　　　JB为职业
　　　　　LV为查询代码(就是发送的LV)
　　　　　MO为移动电话
1 q4 @0 Y1 K$ x& R　　　　　MT为未知
　　　　　MV为未知
　　　　　PC为邮编
, W% P2 c2 x/ v' }( M　　　　　PH为联系电话
4 u2 Q! ?* F2 m' m　　　　　PR为简介
　　　　　PV为省
% G) G8 b# Y" h, G. k& o  J　　　　　RN为真实姓名
　　　　　SC为毕业院校
- u0 {4 D3 W8 ~. L4 d( |　　　　　SH为生肖
4 c6 M! B) ], d9 ~6 ^. j/ ]　　　　　SX为性别
) d% `& j0 u. i0 r6 V　　　　　UN为QQ号
# O! _. h9 _$ \( ~3 f　　　　　NK为昵称
1 u5 a8 W& ]9 Q8 B
　　　　　血型：0 => '',
　　　　　　　　1 => 'A型',
　　　　　　　　2 => 'B型',
　　　　　　　　3 => 'O型',
$ I$ i$ {, a) A: t5 u　　　　　　　　4 => 'AB型',
% M' a8 ^5 `# {4 |: h, w　　　　　　　　5 => '其他'

9 j* x# n- N7 D5 e! S
, c9 Z* H% A' A6 L  }" C) N　　　　　星座：0 => '',
8 W8 b7 ^1 P- Q& p: U" F) L1 ?　　　　　　　　1 => '水瓶座',
　　　　　　　　2 => '双鱼座',
! R$ f) X1 U5 D" P$ N　　　　　　　　3 => '牡羊座',
$ i9 _  V4 s/ m! [　　　　　　　　4 => '金牛座',
　　　　　　　　5 => '双子座',
　　　　　　　　6 => '巨蟹座',
: Y( S( |  b0 A' y! Q　　　　　　　　7 => '狮子座',
* l, f1 c) Q* b/ d$ [2 S% S& L% Z　　　　　　　　8 => '座',
　　　　　　　　9 => '天秤座',
8 S( l+ u2 A# G$ q, \) W　　　　　　　　10 => '天蝎座',
9 |  o6 f7 b* w! x- n. B8 J　　　　　　　　11 => '射手座',
/ {6 P; a: Q. _$ t* Q/ j　　　　　　　　12 => '摩羯座'

3 G/ N; G; ?$ H, `$ n" M　　　　　生肖：0 => '',
　　　　　　　　1 => '鼠',
3 G7 U$ A3 D7 d5 {　　　　　　　　2 => '牛',
　　　　　　　　3 => '虎',
$ q4 c' ~4 q  f) I- _　　　　　　　　4 => '兔',
1 H; X5 a- W5 N( H8 H$ p　　　　　　　　5 => '龙',
　　　　　　　　6 => '蛇',
　　　　　　　　7 => '马',
" N+ Q% ^! @+ U' f0 `5 E" m2 }4 D　　　　　　　　8 => '羊',
) O8 q9 S) E' K　　　　　　　　9 => '猴',
　　　　　　　　10 => '鸡',
　　　　　　　　11 => '狗',
　　　　　　　　12 => '猪'
* \' J* ]! s" p6 L/ |# Q* f9 M
- N( T3 P4 E/ H- T6 S　　　　　性别：0 => '男',
　　　　　　　　1 => '女'
; _& M- Q+ L& E; o' K
(5).增加好友
4 i, k& k# o- ?; |　　提交数据：VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号
$ N0 t  }; Y( L4 t( ^
0 Q. M* I5 `1 ~1 G- J" a8 ?# _　　返回：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号(需要验证)
# Z: r7 d, s4 I0 {1 c7 l% W. P　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=0&CD=2&UN=对方QQ号(决绝被加为好友)
5 p  ?6 }9 Y& j: ?( ?　　　　　VER=1.1&CMD=AddToList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
8 i$ H6 N: `& l0 C9 a　　　　　NULL(UIN、UN为字符)
5 ^0 V, X  R  H7 s
+ i9 t- E' W1 Z$ J* P# x0 b) A(5).发送验证
　　说明：1、如果你加对方为好友，你需要发送验证
　　　　　2、对方加你为好友，发送了验证，你要通过或者拒绝
1 [0 D* `7 i: f* M　　　　　这2种情况需要发送验证消息

; I' ^, e+ o2 w8 i) e3 ^, H6 G　　提交数据：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&UN=对方QQ号&CD=验证类型&RS=理由
. |1 C0 M5 N' q7 g8 O% t; o, J/ K　　说明：CD为0表示“通过验证”，CD为1表示“拒决加为对方为好友”，CD为2表示“为请求对方加为好友”。

2 c& f. Q8 \5 Y　　返回：VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=0(成功)
　　　　　VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=3(*)
+ H8 t& H) z' x4 G* X; T　　　　　VER=1.1&CMD=Ack_AddToList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
" K  }+ W1 d+ q　　　　　NULL(UIN、UN、CD为字符，RS为非UTF-8字符)
1 A2 L0 T$ A' C# C　　*如果服务器返回RES=3，那么这次对话的响应时间在20s。当发送验证请求的时候，必须连发2次(请求内容不必一样)，其中一条RES=3，对方收不到，一条RES=0，对方能够收到。当CD>=3时，RES=3，响应时间20s。
/ ^( B1 f2 t4 E! v! q3 n
(6).删除好友
0 B) s9 S' J" D/ D0 r' P* T　　提交数据：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&UN=删除的QQ号
+ G9 f9 N3 l6 o5 v
　　返回：VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=0&(成功)
6 ?) m. ^: S2 c( H) `8 `0 s　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=3(响应时间30s，重复发送的后果)
8 n/ }; I8 I" p% H' k4 @' h, n　　　　　VER=1.1&CMD=DelFromList&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、UN为字符)

& c6 q* z0 J. z6 Z- x5 s8 G) t(7).改变状态
8 i4 L( {$ T5 |$ M4 O! Q& R8 H8 |　　提交数据：VER=1.1&CMD=Change_Stat&SEQ=标记&UIN=QQ号&ST=状态代码
　　说明：状态代码：10为上线，20为离线，30为忙碌，40为隐身，其他视为非法
$ _' k" |: l( U6 I5 A9 {' @
/ Y) ?6 |" n3 Z# T' x' ^6 P　　返回：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非法)

; O; [: I: q0 u, o6 u　　特别说明：如果你改变好友，将会给所有好友发送一条系统信息，内容就是状态代码；如果隐身，发送的状态代码为20，表示离线。
　　　　　　　同理，当你的好友改变状态，你也会收到一条系统信息。

* P% x( }% U5 {4 B' f(9).获得消息
　　提交数据：VER=1.1&CMD=GetMsgEx&SEQ=标记&UIN=QQ号
% m# H. a$ L, [$ H
3 B9 x- x* n; T- K) K2 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的值用","分割，分别表示消息类型、发送人号码、消息内容)
　　　　　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(没有正确登陆)
# S0 ~9 `2 c5 s3 |) |　　　　　NULL(UIN为字符)
/ N6 g3 S; u. e  ]( G, w1 {, V* x: p　　说明：关于MT：
　　　　　　　9为用户消息，99为系统消息，2为请求信息，3为通过验证，4为拒绝被加好友
　　　　　关于MG：
- C  K& T- `) e2 k  v　　　　　　　当MT=9时，MG为用户发送的消息内容
　　　　　　　当MT=99时,
　　　　　　　　　MG=10(QQ_STATUS_ONLINE)表示对方上线
: C: ]" X& G9 O( T　　　　　　　　　MG=20(QQ_STATUS_OFFLINE)表示对方下线
　　　　　　　　　MG=30(QQ_STATUS_BUSY)表示对方进入忙碌状态
+ P2 |7 K" c) O7 ~　　　　　　　当MT=2时，MG为对方请求你验证的信息
　　　　　　　当MT=3时，表示对方通过你的验证
  D3 H4 y& _& _3 C* x5 f　　　　　　　当MT=4时，MG为对方拒绝你理由
9 w; P! D, E6 [% w9 u# a
(10).发送消息
; _4 B- J/ v& X# j3 f　　提交数据：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&UN=对方QQ号&MG=发送内容
- r0 a+ ~4 i+ W2 D0 L# ]
* {3 w7 K4 V) p1 P" W　　返回：VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=0&(成功发送，对方不一定能收到哦)
" G: ]9 T$ W6 Z/ P　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=3(发送过快)
. J2 J& s. p6 o+ w　　　　　VER=1.1&CMD=CLTMSG&SEQ=标记&UIN=QQ号&RES=20(没有正确登陆)
　　　　　NULL(UIN、UN为字符，MG含非UTF-8字符)
　　说明：1、当你发消息时，以下情形对方可能看不到(其实是收到了，QQ不提示)你发送的消息：
　　　　　　　你俩互为陌生人，且对方没有和你说过话
　　　　　　　你在他的陌生人列表里，并且他没有和你说过话(没有验证)
/ \0 O) h5 u" v: E  j6 v/ q% T" d( P　　　　　2、当你过快发送消息时，系统会给你一个惩罚，RES=3，相应时间20s
　　　　　3、当我发送含有小写字母h的信息时，服务器有可能返回NULL

# D: U" l1 g1 K(11).登出
+ t$ j- F) b) T9 ^& z5 ?, ?　　提交数据：VER=1.1&CMD=Logout&SEQ=标记&UIN=QQ号
; e, }& y! g, {3 B% U4 D
　　返回：VER=1.1&CMD=LOGOUT&SEQ=标记&UIN=QQ号&RES=0(成功，好像永远成功的，不管你是否登陆)
　　　　　NULL(UIN为字符)

- O, d- B# L! w1 Z５、总结

, Y' j4 \$ j: J　　通过对照以上的接口说明，我开发出了能够实现基本QQ功能的PHP类，它整合了以上所有的接口，使用更方便，可以开发QQ机器人、群发广告程序等。免费获得类的代码请到
　　http://blog.hackfan.net/index.ph ... d=a_20050819_223558
& K3 v4 p3 e$ W8 u6 Z6 @2 d6 t　　本文撰写时间仓促，难免有误，希望各位不吝赐教
0 q% S( m% ^  L" ]. e
1 ]- G% Q1 `1 I8 h/ i" j/ ?
& D: j' x' ?6 ITrackback: http://tb.donews.net/TrackBack.aspx?PostId=520301