三竹资讯简讯系统整合介面.docVIP

PAGE 1/ NUMPAGES 14 Http(s)三竹格式發送 SmGateway也支援客戶呼叫Http或Https來發送簡訊，通常使用這種方式的原因是發送量不大，客戶端無法或不方便安裝SmGateway及其所需的資料庫。 若需要使用Http(s)發送簡訊，必須向三竹簡訊中心申請，在SmGateway中開啟Http(s)發送權限後方可使用。 Http(s)的簡訊發送可用IE的網址列中直接輸入URL來做測試，建議程式撰寫前先用IE測試，以確定系統的運作與預期的結果是一致的，之後再進行程式的撰寫。此外，程式開發及測試的過程中，亦可用IE作為測試的工具及對照組。 使用Http(s)發送簡訊，如果客戶端到SmGateway間的網路傳輸有狀況發生，客戶端必須以人工進行查詢，以確定該筆(批)簡訊SmGateway是否已收下。若省略查詢直接重送簡訊，可能造成重複發送。若直接忽略不重送，則可能造成簡訊漏送。 以Http(s)發送三竹格式的簡訊分為單筆及多筆兩種，單筆使用Get method，多筆使用Post method 呼叫，說明如下： 單筆簡訊發送 SmSendGet.asp 發送(請勿換行) .tw:9600/SmSendGet.asp?username=Test001password=TestPwddstaddr=09001234567DestName=王先生dlvtime=20060811093000vldtime=20060812093000smbody=%C2%B2%B0T%B4%FA%B8%D5response=00/smreply.asp 欄位 最大長度 說明 1 username 20, 必要 使用者帳號。SmGateway資料庫表格SMUser中需有此使用者，且狀態為啟用。 2 password 24, 必要 使用者密碼。 3 dstaddr 20, 必要 受訊方手機號碼。請填入09帶頭的手機號碼。 4 encoding 10 smbody及DestName的編碼方式(預設值為Big5)： Big5 Unicode utf-16le utf-16be UTF8 其中Unicode即為utf-16le 注意事項1：雖然三竹支援客戶指定編碼方式，但這是用於將資料轉成Big5的格式。若送來日文、韓文、簡體中文..等的unicode，保證送出去一定不是所要的結果。 注意事項2：編碼的轉換是透過Window的CodePage做轉換。不保證每一個看起來像繁體中文的Unicode都能完美的對應到Big5的內碼，請測試OK後再上線，轉換結果若有缺陷，只能敬請見諒。 5 DestName 36 收訊人名稱。若其他系統需要與簡訊資料進行系統整合，此欄位可填入來源系統所產生的Key值，以對應回來源資料庫。 6 dlvtime 14 簡訊預約時間。也就是希望簡訊何時送達手機，格式為YYYY-MM-DD HH:NN:SS或YYYYMMDDHHNNSS，或是整數值代表幾秒後傳送。 若預約時間大於系統時間，則為預約簡訊，預約時間離目前時間若預約時間已過或為空白則為即時簡訊。即時簡訊為儘早送出，若受到MsgType宵禁欄位的限制，就不一定是立刻送出。 7 vldtime 14 簡訊有效期限。格式為YYYY-MM-DD HH:NN:SS或YYYYMMDDHHNNSS，或是整數值代表傳送後幾秒後內有效。 請勿超過大哥大業者預設之24小時期限，以避免業者不回覆簡訊狀態。 8 smbody 256, 必要 簡訊內容。必須為BIG-5編碼，長度70個中文字或是160個英數字。若有換行的需求，請填入ASCII Code 6代表換行。為避免訊息中有電文分隔符號，請將此欄位進行url encode。 url encode時，空白可用%20或維持空白即可，請勿將空白encode為+號。若對url encode有任何的相容性疑慮，建議使用%FF的方式將參數內容全部編碼即可。 9 response 256 狀態回報網址。請參考狀態回報的說明。 10 ClientID 36 客戶簡訊ID。用於避免重複發送，若有提供此參數，則會判斷該簡訊ID是否曾經發送，若曾發送過，則直接回覆之前發送的回覆值，並加上Duplicate=Y。 這個檢查機制只留存12小時內的資料，12小時候後重複的ClientID”可能”會被當成新簡訊。此外，ClientID必須維持唯一性，而非只在12小時內唯一，建議可使用GUID來保證其唯一性。 發送回覆 [1] msgid=0311216968 statuscode=1 AccountPoint=126 換行符號為CL+LF, 亦即 ASCII(13)+ASCII(10) 欄位 最大長度 說明 1 [1] 請忽略 2 msgid 10 簡訊序號。為