1.介面简介-台湾固网.doc

PAGE  PAGE 7 台湾固網股份有限公司 商務簡訊系統MO介面 規格書 Version 1.2 2004/03/08  TOC \o 1-3  1. 介面簡介  PAGEREF _To\h 3 2. Http介面說明  PAGEREF _To\h 3 一. 利用HTTP協定中Get Method來接收MO簡訊結果，其參數如下:  PAGEREF _To\h 3 二. 企業用戶之伺服器回覆台灣固網MO系統的，其參數如下:  PAGEREF _To\h 4 三. 範例  PAGEREF _To\h 5  介面簡介 企業用戶需向台灣固網申請MO門號。 企業用戶需提供接收台灣固網MO簡訊之回覆網址及MO發送代碼(兩位數字之自定號碼) 。相關申請/異動單請參考附件”台灣固網商務簡訊MO專屬代碼申請/異動單”及其範例。 企業用戶需撰寫一接收程式放置於企業用戶端，其檔名及路徑不可更動。 台灣固網MO系統將以HTTP GET method方式呼叫此一程式， 遞送手機之MO簡訊。 企業用戶之接收程式必須回覆台灣固網MO系統，表示已成功接收MO簡訊的結果 HTTP介面說明 利用HTTP協定中GET Method來接收MO簡訊結果，其參數如下: 表一: MO接收Tag清單如下 Tag意義Msgid訊息代號Moid發送代碼兩位數字之自定號碼。Srcaddr發話者手機號碼Dstaddr受話者手機號碼SmbodyURL encoding的簡訊內文EncodingEncoding Schema Name，目前值為ASCII 或 BIG5備註 : smbody的Value，台灣固網MO系統會自動將其作URL encoding，企業用戶端需自行解碼。 如果無法連上企業用戶之機器，或連上企業用戶之機器後用戶沒有回覆TFN，TFN系統會視為用戶沒有收到回報而重複re-try，但總共最多嘗試三次，超過便不再回報。 企業用戶之伺服器需回覆台灣固網MO系統參數如下: 表二: MO回覆Tag清單如下 Tag意義magicid:固定值(tfnmo_sms_gateway_rpack)msgid:與表一的msgid相同備註 : 企業用戶於回覆回報之HTTP GET，台灣固網MO系統預期得到狀態碼為200的HTTP狀態,Type為Text/Plain,內容含magicid= tfnmo_sms_gateway_rpack\nmsgid=MsgId\n 範例 假設企業用戶提供之回覆網址為 HYPERLINK /responsemo.cgi /responsemo.cgi，發送碼為11及當時申請MO電話為0961238100時，則台灣固網MO系統將傳送MO簡訊到企業用戶如下  HYPERLINK /responsemo.cgi?msgid=123456moid=11srcaddr=0935123456dstaddr=0961238100smbody=testencoding=ASCII /responsemo.cgi?msgid=123456moid=11srcaddr=0935123456dstaddr=0961238100smbody=testencoding=ASCII 企業用戶提供之回覆網址為 HYPERLINK /responsemo.cgi 用戶收到回報後回覆的內容為：(必須要回覆資料,否則台灣固網MO系統將會retry,詳見介面說明) magicid=tfnmo_sms _gateway_rpack msgid=123456 台灣固網商務簡訊MO專屬代碼申請/異動單 公司代碼填表日期　　　年　　　月　　　日公司名稱 項目代碼MO回覆網址虛擬手機門號□新增 □刪除□新增 □刪除□新增 □刪除□新增 □刪除□新增 □刪除□新增 □刪除□新增 □刪除□新增 □刪除□新增 □刪除□新增 □刪除□新增 □刪除□新增 □刪除□新增 □刪除□新增 □刪除□新增 □刪除□新增 □刪除□新增 □刪除□新增 □刪除□新增 □刪除註：項目欄位請以R勾選，若屬新增者則虛擬手機門號欄位由台灣