C#實現QQ介面軟體–QQ的HTTP介面協議探究

文章目錄

•  

 

１、研究說明
Tencent在tqq.tencent.com的8000有一個使用HTTP的QQ介面，通過這個介面，可以進行一些基本的操作，如：登陸、登出、改變登陸狀態(上線、忙碌、離線、隱藏)、添加移除朋友、查看好友資訊、發送驗證資訊(接受被加為好友、申請加對方為好友、拒絕被加為好友)、收發使用者訊息、系統資訊。
目前我研究的是1.1版本的HTTP QQ協議，研究是微程在的成果上進行的，不敢說有什麼超越，只不過更為詳細和準確。
２、介面說明：
介面位置：tqq.tencent.com:8000
通訊協定：HTTP
資料轉送方法：POST
HTTP請求格式：
POST HTTP/1.1
Host: tqq.tencent.com:8000
Content-Type: text/plain; charset=UTF-8
Content-length: 長度
Connection: close
資料
其中長度為 資料 的長度，資料的格式：
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還需要不同的參數，下面我就公布我的研究成果。
3、研究成果：
(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
說明：QQ密碼是通過md5加密的字串，在PHP中可以直接用md5()進行加密；
M5這個參數的作用還不清楚，但最好為1。
LC這個參數有點神秘，不能有絲毫改動，不然伺服器就沒有響應(沒有響應就是返回NULL)。
返回：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錯誤)
(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(沒有正確登陸)
NULL(UIN、TN、UN為字元)
(3).得到線上好友名單
提交資料：VER=1.1&CMD=Query_Stat&SEQ=標記&UIN=QQ號&TN=50&UN=0
說明：TN、UN還不清楚具體表示什麼，但是TN的值會影響返回的結果，有沒有UN對結果沒有影響
返回：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為字元)
說明：FC為QQ頭像的的ID，如的頭像ID為270，那麼其頭使用的圖片為91.bmp,其演算法為ID/3+1；
ST為QQ使用者的狀態，10為上線，20為離線(或隱藏)，30為忙碌；
特別說明：當參數TN=0或不存在時，伺服器返回：
VER=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
Content-Length: 56
VER=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
VER=1.1&CMD=QUERY_STAT&SEQ=標記&UIN=QQ號&RES=0&FC=&FN=1&SN=0&ST=&UN=&NK=
返回了２次，第一次的結果中，FN為線上好友數，第二次返回的資料基本沒用。
(4).查看好友資訊
提交資料：VER=1.1&CMD=GetInfo&SEQ=標記&UIN=QQ號&LV=查詢類型&UN=被查詢QQ號碼
說明：LV=0,1為精簡查詢，LV=2為普通查詢，LV>=3為詳細查詢
返回：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 
好(普通查詢)
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 好(詳細查詢)
VER=1.1&CMD=GETINFO&SEQ=標記&UIN=QQ號&RES=20(沒有正確登陸)
NULL(UIN、LV、UN為字元)
說明：AD為聯絡地址
AG為年齡
BT為血型
CO為星座
CT為城市
CV為未知*
CY為國家
EM為Email
FC為頭像
HP為網站
ID為未知
JB為職業
LV為查詢代碼(就是發送的LV)
MO為行動電話
MT為未知
MV為未知
PC為郵編
PH為聯絡電話
PR為簡介
PV為省
RN為真實姓名
SC為畢業院校
SH為生肖
SX為性別
UN為QQ號
NK為暱稱
血型：0 => ‘‘,
1 => ‘A型‘,
2 => ‘B型‘,
3 => ‘O型‘,
4 => ‘AB型‘,
5 => ‘其他‘
星座：0 => ‘‘,
1 => ‘水瓶座‘,
2 => ‘雙魚座‘,
3 => ‘牡羊座‘,
4 => ‘金牛座‘,
5 => ‘雙子座‘,
6 => ‘巨蟹座‘,
7 => ‘獅子座‘,
8 => ‘處女座‘,
9 => ‘天秤座‘,
10 => ‘天蠍座‘,
11 => ‘射手座‘,
12 => ‘摩羯座‘
生肖：0 => ‘‘,
1 => ‘鼠‘,
2 => ‘牛‘,
3 => ‘虎‘,
4 => ‘兔‘,
5 => ‘龍‘,
6 => ‘蛇‘,
7 => ‘馬‘,
8 => ‘羊‘,
9 => ‘猴‘,
10 => ‘雞‘,
11 => ‘狗‘,
12 => ‘豬‘
性別：0 => ‘男‘,
1 => ‘女‘
(5).增加好友
提交資料：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(沒有正確登陸)
NULL(UIN、UN為字元)
(5).發送驗證
說明：1、如果你加對方為好友，你需要發送驗證
2、對方加你為好友，發送了驗證，你要通過或者拒絕
這2種情況需要發送驗證訊息
提交資料：VER=1.1&CMD=Ack_AddToList&SEQ=標記&UIN=QQ號&UN=對方QQ號&CD=驗證類型&RS=理由
說明：CD為0表示“通過驗證”，CD為1表示“拒決加為對方為好友”，CD為2表示“為請求對方加為好友”。
返回：VER=1.1&CMD=Ack_AddToList&SEQ=標記&UIN=QQ號&RES=0(成功)
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。
(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(沒有正確登陸)
NULL(UIN、UN為字元)
(7).改變狀態
提交資料：VER=1.1&CMD=Change_Stat&SEQ=標記&UIN=QQ號&ST=狀態碼
說明：狀態碼：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，表示離線。
同理，當你的好友改變狀態，你也會收到一條系統資訊。
(9).獲得訊息
提交資料：VER=1.1&CMD=GetMsgEx&SEQ=標記&UIN=QQ號
返回：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：
當MT=9時，MG為使用者發送的訊息內容
當MT=99時,
MG=10(QQ_STATUS_ONLINE)表示對方上線
MG=20(QQ_STATUS_OFFLINE)表示對方下線
MG=30(QQ_STATUS_BUSY)表示對方進入忙碌狀態
當MT=2時，MG為對方請求你驗證的資訊
當MT=3時，表示對方通過你的驗證
當MT=4時，MG為對方拒絕你理由
(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(沒有正確登陸)
NULL(UIN、UN為字元，MG含非UTF-8字元)
說明：1、當你發訊息時，以下情形對方可能看不到(其實是收到了，QQ不提示)你發送的訊息：
你倆互為陌生人，且對方沒有和你說過話
你在他的陌生人列表裡，並且他沒有和你說過話(沒有驗證)
2、當你過快發送訊息時，系統會給你一個懲罰，RES=3，相應時間20s
3、當我發送含有小寫字母h的資訊時，伺服器有可能返回NULL
(11).登出
提交資料：VER=1.1&CMD=Logout&SEQ=標記&UIN=QQ號
返回：VER=1.1&CMD=LOGOUT&SEQ=標記&UIN=QQ號&RES=0(成功，好像永遠成功的，不管你是否登陸)
NULL(UIN為字元