`
lukeshei
  • 浏览: 367426 次
  • 性别: Icon_minigender_1
  • 来自: 台北
社区版块
存档分类
最新评论

msn機器人訊息控制開發套件使用手冊

SOAPCGIYahooLinuxDelphi 
阅读更多

http://msnrobot.blog.163.com

http://www.imoo.tw

 

 

msn機器人訊息控制開發套件使用手冊

 

訊息控制開發套件v1.03

 

 

版權聲明

本手冊內容僅做為系統操作學習之用。

 

 

商標聲明

本手冊內容中所引用之各商標及商品稱名稱分屬合法註冊公司所有,特此聲明。

 

 

目        錄

 

 

1.  注意事項        

2.   示意圖

3.   程式介面型態

3.1  SOAP

3.2  CGI

3.3  ADO

4.    SOAP 程式介面

4.1. WSDL 位置

4.2. API Functions

5.    CGI/ADO程式介面

6.    附錄

 

 

1.  注意事項

 

1.0.  系統本身有unix/linux/win32版本,如需測試可聯繫 http://www.imoo.tw / service@imoo.tw

1.1.  msn機器人 / gtalk機器人 / yahoo即時通 同時適用,api發送訊息/註冊聯絡人…功能

1.2.  實務應用中,MSN 要能發送訊息,必須先將欲發送的MSN帳號設定為聯絡人,請參考下面

表列中REGISTER指令,也請參考這個資訊 http://rd-program.blogspot.com/2008/08/msn-bug.html

1.3.  範例中網路連接位置請依照實際情況處理,文件以 http://127.0.0.1:8080 示意

1.4.  範例中慣例以 luke@hotmail.com 為msn機器人服務帳號 xue@hotmail.com…為一般聯絡人

1.5.  以下\t 代表tab \n代表unix斷行格式

1.6.  範例中所提到的參數 uids 為多個帳號組合之意,分隔符號為 逗點(,) 但;當只有一個帳號時,不應在後方留置逗點,uids意指msn passport帳號(包含網域)--例:account@hotmail.com

1.7.  SOAP範例中使用 func_name(‘parameter’) ; 意指parameter為參數,單引號為標示之用,實際的參數並不包含單引號(‘)

1.8.  回應值除了ADO介面必為big5以外,其餘皆以utf-8字集回應

1.9.  範例中對於目錄的標示 / 與 \ 相同,代表相同的目錄標示

1.a.  發送訊息/註冊聯絡人...,函式會自動處理過長資訊分成多個訊息處理,此外;系統會自行調整發送頻率,以防止被視為惡意訊息...

1.b.  本文建置放於 ./doc/之下

1.c.  線上狀況(Presence)代碼與中文對照(GTalk/Yahoo即時通已會對應成下列代碼)

       YAL 已註冊為聯絡人;但對方尚未核准

       NLN 線上

       BSY 忙碌中

       IDL 未使用電腦

       FLN 離線

       PHN 通話中

       AWY 離開

       BRB 立刻回來

       LUN 外出用餐

       HDN 顯示為離線

1.d.  CGI範例中常用之URL-encoded對照表(僅供參考,實際應使用您的程式語言函式轉換)

      底線(_) -> %5F         逗點(,) -> %2C

      AT (@) -> %40         空白( ) -> %20

      點 (.)  -> %2E

 

 

2.  示意圖

 

※ MSN與MSN小圖均為Microsoft微軟公司在美國和其他國家使用之商標 ※

 

 

 

3.  程式介面型態

 

3.1. SOAP

 

3.2. CGI

 

3.3. ADO(可適用vb6 delphi asp)

 

 

4.  SOAP 程式介面

 

4.1. WSDL 位置

http://127.0.0.1:8080/msnSDK/genwsdl-win32  

 

4.2. API Functions

Method

Description

MSNSDK_VERSION

查詢系統版本,此版本資訊與文件命名相符,當使用相關方法(Method)前,應先確認版本後才開始呼叫使用,這樣才能讓程式在不同版本之間向下相容

GETSPID

取得授權碼,確認是否可使用API,取得的認證碼有效期限為6小時

SENDMSG

傳送MSN 訊息,其內容msg中文編碼為(utf-8/big5/gbk/gb2312),傳給uids;flags (0 對方離線則不送訊息 1對方離線則訊息是否傳送由系統決定),而uids 允許傳遞給多人,當傳給多人時應使用逗點隔開

備註1:flags 預設為0對方離線則不送訊息

備註2:訊息如需換行,請使用 \n (2個字元)

 

mmsimtype決定訊息的顏色/字型…屬性,請參考最下方的附錄說明: (X-MMS-IM-Format).Ex. CO=ff; FN=%E7%B4%B0%E6%98%8E%E9%AB%94; ->訊息為紅色字型為細明體,當此參數未填時,系統會使用預設值

SENDNUDGEMSG

先傳送來電震動,再傳送MSN 訊息,其內容msg中文編碼為(utf-8/big5/gbk/gb2312),傳給uids;flags (0 對方離線則不送訊息 1對方離線則訊息是否傳送由系統決定),而uids 允許傳遞給多人,當傳給多人時應使用逗點隔開

備註1:flags 預設為0對方離線則不送訊息

備註2:訊息如需換行,請使用 \n (2個字元)

 

mmsimtype決定訊息的顏色/字型…屬性,請參考最下方的附錄說明: (X-MMS-IM-Format).Ex. CO=ff; FN=%E7%B4%B0%E6%98%8E%E9%AB%94; ->訊息為紅色字型為細明體,當此參數未填時,系統會使用預設值

PRESENCE

查詢某個帳號(或全部)的線上狀況

REGISTER

依照系統自動隨機選擇機器人服務帳號來註冊帳號聯絡人;備註:請參考http://rd-program.blogspot.com/2008/08/msn-bug.html

REGISTER_ATMSN

依照系統自動隨機選擇msn機器人服務帳號來註冊帳號聯絡人,但強制此帳號註冊在MSN

備註:這個函式用於使用yahoo帳號作為MSN使用

UNREGISTER

取消聯絡人註冊

SERVICEID_STATISTIC

每個msnSDK serviceID目前註冊的人數

KW2PASSPORT_ADD

新增一組關鍵字(群組/個別非MSN帳號)與MSN帳號的對應

KW2PASSPORT_DELETE

刪除一組關鍵字(群組/個別非MSN帳號)與MSN帳號的對應

KW2PASSPORT_MODIFY

修改一組關鍵字(群組/個別非MSN帳號)與MSN帳號的對應

KW2PASSPORT_APPEND

在一組關鍵字(群組/個別非MSN帳號)與MSN帳號的對應裏添加MSN帳號資訊

KW2PASSPORT_FIND

尋找關鍵字與MSN帳號的對應的內容

KW2PASSPORT_KWLIST

表列系統中所有關鍵字

SENDMSG_BY_KEYWORD

使用關鍵字對應出來的MSN帳號傳送訊息

備註1:flags 預設為0對方離線則不送訊息

備註2:訊息如需換行,請使用 \n (2個字元)

 

錄說明: (X-MMS-IM-Format).Ex. CO=ff; FN=%E7%B4%B0%E6%98%8E%E9%AB%94; ->訊息為紅色字型為細明體,當此參數未填時,系統會使用預設值

SENDNUDGEMSG_BY_KEYWORD

使用關鍵字對應出來的MSN帳號傳送來電震動與訊息

備註1:flags 預設為0對方離線則不送訊息

備註2:訊息如需換行,請使用 \n (2個字元)

 

錄說明: (X-MMS-IM-Format).Ex. CO=ff; FN=%E7%B4%B0%E6%98%8E%E9%AB%94; ->訊息為紅色字型為細明體,當此參數未填時,系統會使用預設值

MOD_NICKNAME

修改暱稱(希望其他人看到的名稱)

MOD_PSM

修改個人資訊(希望聯絡人看到的個人資訊)

QRY_NICKNAME

查詢暱稱

QRY_PSM

查詢個人資訊

MSNSERVICE_STOP

關閉 msnSDK 服務

MSNSERVICE_START

啟動 msnSDK 服務

MSG_SUSPEND

關閉/啟用/查詢 訊息通知,一經關閉,所有訊息不再傳遞

ADPUSH

資訊推撥,取代選單上的<ad id=’訊息編號’/>標籤

ADCANCEL

取消推撥訊息

 

 

MSNSDK_VERSION

參數(Parameters)

MSNSDK_VERSION 沒有任何參數

回應值(Returns)

(成功) 1\tVersion: 1.0.3\n

 

 

GETSPID

<

0
顶
0
踩
分享到：
| 你的主機商支援 即時通訊機器人服務 了嗎 ...
评论
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

Magicbox
Global site tag (gtag.js) - Google Analytics