簡訊平台介面說明

2021-08-10 15:24:47 字數 2055 閱讀 9991

說明version 3.6

目錄1 普通簡訊傳送 4

1.1 簡訊提交位址 4

1.2 引數定義 4

1.3 簡訊提交響應 5

1.3.1 格式說明 5

1.3.2 示例 5

1.3.3 響應狀態值說明 6

1.4 注意事項 6

1.5 簡訊傳送例子 7

2 變數簡訊傳送 7

2.1 系統提交url位址 7

2.2 引數定義 7

2.3 提交響應 8

2.3.1 提交成功 8

2.3.2 提交失敗 9

2.3.3 響應狀態值說明 9

2.4 示例 9

3 簡訊包傳送 9

3.1 系統提交url位址 9

3.2 引數定義 10

3.3 提交響應 10

3.3.1 提交成功 10

3.3.2 提交失敗 11

3.3.3 響應狀態值說明 11

3.4 示例 11

4 狀態報告推送 11

4.1 引數定義 12

4.2 狀態報告值 12

4.3 示例 12

5 簡訊接收 13

5.1 引數定義 13

5.2 示例 13

6 額度查詢介面 13

6.1 介面位址 13

6.2 引數定義 13

6.3 提交響應 14

6.4 提交響應值 14

6.5 示例 14

7 附錄 14

本文件主要定了簡訊平台對使用者開放的主要介面和定義。

使用者通過http的post方式提交簡訊傳送請求。簡訊傳送介面,區分為簡訊單發和簡訊**兩個介面。

簡訊提交分為單發和**(賬戶是否具有單發和**的功能需要管理員進行功能的開通)。單發只能提交單個手機號碼,**可以提交不超過50000個手機號碼,每個號碼用英文逗號間隔。

區別單發和**主要在於傳送的介面url位址入口不同。

單發的url位址為:

**的url位址為:

注:其中ip:port為服務部署的位址和埠。

使用者簡訊通過http請求提交到伺服器後,伺服器返回響應碼,響應碼的格式如下:

簡訊提交響應分為兩行,第一行為響應時間和狀態,第二行為伺服器給出提交msgid。無論傳送的號碼是多少,乙個傳送請求只返回乙個msgid,如果響應的狀態不是「0」,則沒有msgid即第二行資料。(每行以換行符(0x0a,即\n)分割)

提交成功

響應時間為20110725160412,響應狀態為0 表明那個成功提交到伺服器;1234567890100為返回的msgid,這個工狀態報告匹配時使用。

提交失敗

本示例表明使用者提交失敗,返回錯誤碼為101,伺服器端並未返回msgid。

使用者**簡訊如果有審核的限制,則客戶的簡訊必須經過管理人員的審核,審核通過後才能被提交到行業閘道器進行簡訊實際傳送。

使用者**簡訊必須滿足手機號碼最低個數的限制,低於系統設定的**最小手機號碼數,則該提交請求會被拒絕,響應碼為108。

簡訊單發

簡訊**

簡訊單發和**的url入口位址有區別,並且其中的ip位址192.l68.168.168需要根據系統部署的實際位址填寫。

使用者通過http的post方式提交簡訊傳送請求。

響應時間為20110725160412,響應狀態為0 表明那個成功提交到伺服器,引數組個數為10表明提交引數params中格式正確的條數為10條, 傳送包失敗個數為1表明提交引數msg中格式錯誤的條數為1條;1234567890100為返回的msgid,這個供狀態報告匹配時使用。

本示例表明使用者提交失敗,返回錯誤碼為101,伺服器端並未返回msgid。

簡訊平台CGI介面規範及測試v1

v1.2 1 cgi介面方式 cgi介面協議主要分兩類 1 使用者呼叫簡訊平台提供的cgi伺服器提供服務。簡訊平台為使用者提供了一種最方便和便於採用的方式,使用者只需要通過瀏覽器輸入簡訊平台伺服器cgi的url通過提交相應的表單資料,就可以完成簡訊息服務。2 使用者通過採用簡訊平台提供的cgi程式,...

簡訊平台管理辦法

試行 1 目的 為了加強對我公司簡訊平台的使用和安全管理,建立規範的審批和使用機制,促進簡訊平台規範執行,特制定本辦法。2 適用範圍 本辦法適用範圍為使用簡訊平台的市局 公司 各科室 中心 和縣局 營銷部 3 職責 3.1 市局資訊中心負責簡訊平台的管理工作,並負責日常使用的培訓 許可權分配等協調工...

簡訊平台管理辦法

試行 1 目的 為了加強對 簡訊平台的使用和安全管理,建立規範的審批和使用機制,促進簡訊平台規範執行,特制定本辦法。2 適用範圍 本辦法適用範圍為使用簡訊平台的市局 公司 各科室 中心 和縣局 營銷部 3 職責 3.1 市局資訊中心負責簡訊平台的管理工作,並負責日常使用的培訓 許可權分配等協調工作。...