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

簡訊王數位媒體?? API協定說明(HTTP)版本: 2010/ 07/ 28版本: 2010/ 03/ 08 補充response 說明版本: 2010/ 01/ 06 BIG5、 url編碼、上修測試數據 版本: 2010/ 01/ 18 雙向api介接說明 簡訊線路規格的選擇API介接前請先評估:若您簡訊發送機制為例如:加入會員手機認證或訂單通知等...一次一通的簡訊發送建議您可以使用即時API。 若您簡訊發送機制為大量發送，一次發送百筆或數千筆甚至數萬筆時，建議您使用大量API。 若您兩種發送需求都有，建議您將時以及大量兩種路由都用上，以需求分配路由，這可以使您的簡訊發送效率大增。※即時API發送速度: 666秒/1,000通※大量API發送速度:?? 秒/,666通”所有”傳送資料都以url編碼，可避免因特殊字元，使得傳送裁斷或顯示異常。 1.介面說明利用HTTP協定中Get Method來發送簡訊,其參數如下URL格式為: 即時api?? 16/kotsmsapi-1.php?Tag=ValueTag=Value…大量api?? 16/kotsmsapi-2.php?Tag=ValueTag=Value…※? 簡訊王以不同的”網址”區隔 即時API 以及 大量API 介接方式 ※Tag清單如下: Tag 意義 username帳號 password密碼 dstaddr目的門號 smbody簡訊內容 dlvtime Dlvtime為簡訊預約發送時間，可使用,YYYY/MM/DD hh24:mm:ss,格式設定建議設定為0即時發送若有預約簡訊需求請於發送時間到達時再傳入簡訊王主機，可解決修改預約以及預約時間限制問題※若使用預約發送YYYY/MM/DD hh24:mm:ss,格式設定時請將所有傳送資料都以url編碼傳送(“日”與”時”之間的空格須轉碼為%20否則無法預約時、分、秒) ?vldtime ※vldtime為發送簡訊的有效期限:當接收手機未開機,系統會重複再次發送給接收門號，您可設定。有效期限,YYYY/MM/DD hh24:mm:ss,格式設定或” 秒數”設定可設定秒數為 1800秒(30分鐘)~28800秒(八小時)。vldtime設定為0秒時有效時間將依簡訊中心流量設定值配送約4~24小時。若vldtime不宣告此參數時，有效期限為預設值8小時。 response 發送簡訊是否成功的狀態回報網址,不回報。 註記：.1? 所有含*的Tag表非必要,若未輸入,系統會帶內定值進去。.2? dlvtime和vldtime只支援二種格式：秒數及YYYY/MM/DD hh24:mm:ss，其餘格式皆不支援。.3? username,password 需加入簡訊王申請.tw 。.4? \n為chr(10).5? 多則簡訊的回覆格式同單則簡訊，但全部的簡訊手機皆接到才算成功，???? 有任一則傳遞不成功即會回覆失敗。回覆狀態有DELIVRD和UNDELIV的情況.6? 文字編碼為ASCII，則smbody最多為160個英文、數字混合字元。.7? 文字編碼為BIG5，則smbody最多為70個中英文混合字元。 ?2.範例? 條件 ? username api01(帳號) password api01(密碼) dstaddr 0933853653 (十位數字門號) smbody 【簡訊王api測試 dlvtime 建議設定為0 秒，可使用,YYYY/MM/DD hh24:mm:ss,格式設定 vldtime 可不代入此參數預設) response ?http://回報網址/response.php (可不代入此參數) 送出簡訊：?ttp://16/kotsmsapi-1.php?username=api01password=api01dstaddr=0933853653smbody=簡訊王api簡訊測試 response=http://回報網址/response.php?收到記錄編號：Kmsgid=5091933 (如果有錯，值為負，請參考錯誤代碼。表一)?如果Vender有於簡訊的request中的response欄位填入Vender接收回報程式的URL?(即response= http://回報網址/response.php)?那麼收到回報內容參數舉例如下：kmsgid=5091933dstaddr=0961000001dlvtime=20070101120000donetime=20070101120010statusstr=DELIVRD (不限於只有這些Tag，擴充用，詳見表二)?response.ph