利用HTTP协定中GetMethod来发送简讯其参数如下-简讯王.DOC

簡訊王數位媒體 API協定說明(HTTP) Api簡訊介接前請將下列網址反紅處(接收門號)修改為您的手機 修改完成後複製此以下文字貼於”網址列”按下”enter”您將可收到此簡訊 .tw/ApiSend.php?username=api01password=api01dstaddr=0933853653smbody=簡訊王api簡訊測試介接體驗dlvtime=2007/00/00 12:00:00vldtime=2007/01/02 12:00:00response=http://回報網址/response.php 1.介面說明 利用HTTP協定中Get Method來發送簡訊,其參數如下： URL格式為: .tw/ApiSend.php?Tag=ValueTag=Value… Tag清單如下: Tag 意義 username: 帳號 password: 密碼 dstaddr: 目的門號 smbody: 簡訊內容 dlvtime:* 空字串時，內定值為0，即馬上傳送。 另外帶YYYY/MM/DD hh24:mm:ss表Schedule Time的功能，目前可預約最久的時間為三天內。 vldtime:* 有效期限,YYYY/MM/DD hh24:mm:ss,或幾秒內有效,本系統預設值為28800秒(八小時)。 response:* 狀態回報網址,內定為 空字串 (不回報) 。 階段動作一： 簡訊王數位媒體系統貴公司網站系統 簡訊王數位媒體系統 貴公司網站系統 階段動作二： 回報簡訊王數位媒體系統貴公司網站系統 回報 簡訊王數位媒體系統 貴公司網站系統 簡訊Request 簡訊Request 註記： 所有含*的Tag表非必要,若未輸入,系統會帶內定值進去。 dlvtime和vldtime只支援二種格式：秒數及YYYY/MM/DD hh24:mm:ss，其餘格式皆不支援。 username,password由本公司提供。 \n為chr(10) 多則簡訊的回覆格式同單則簡訊，但全部的簡訊手機皆接到才算成功，有任一則傳遞不成功即會回覆失敗。回覆狀態有DELIVRD和UNDELIV的情況。 文字編碼為ASCII，則smbody最多為160個英文、數字混合字元。 文字編碼為BIG5、GB2，則smbody最多為70個中英文混合字元。 2.範例 (測試點數不足時請來電告知02-2325-8199) 條件 帳號 api01 密碼 api01 目的門號 0933853653 (十位數字門號) 簡訊內容 簡訊王api簡訊測試 預約時間 2007/01/01 12:00:00 (可不填) 有效期限 2007/01/02 12:00:00 (可不填) 回報地址 http://回報網址/response.php (可不填) 送出簡訊： .tw/ApiSend.php?username=api01password=api01dstaddr=0933853653smbody=簡訊王api簡訊測試dlvtime=2007/00/00 12:00:00vldtime=2007/01/02 12:00:00response=http://回報網址/response.php 利用api傳送資料時，若有特殊字元，請將所有傳送資料都以url編碼，可避免因特殊字元，使得傳送有問題 收到記錄編號： Kmsgid=5091933 (如果有錯，值為負，請參考錯誤代碼。表一) 如果Vender有於簡訊的request中的response欄位填入Vender接收回報程式的URL (即response= HYPERLINK http://回報網址/response.php http://回報網址/response.php) 那麼收到回報內容參數舉例如下： kmsgid=5091933dstaddr=0961000001dlvtime=20070101120000donetime=20070101120010statusstr=DELIVRD (不限於只有這些Tag，擴充用，詳見表二) HYPERLINK http://回報網址/response.php response.php接收回報程式範例： ?php $res=kmsgid=.$_REQUEST[“kmsgid”].\tdstaddr=.$_REQUEST[“dstaddr”].\tdlvtime=.$_REQUEST[“dlvtime”].\tdonetime=.$_REQUEST[“donetime”].\tstatusstr=.$_REQUEST[“statusstr”]; $fp = fopen(retccmoapi.txt,a+); fwrite( $fp, $res); fclose($fp); ? 3.