1、 行專業(yè)之服務，創(chuàng)恒久之價值短信平臺接口說明 目錄1普通短信發(fā)送31.1短信提交地址31.2參數(shù)定義31.3短信提交響應41.3.1格式說明41.3.2示例41.3.3響應狀態(tài)值說明51.4注意事項51.5短信發(fā)送例子61.6參數(shù)定義61.7狀態(tài)報告值61.8示例72短信接收72.1參數(shù)定義72.2示例83額度查詢接口83.1接口地址83.2提交響應83.3提交響應值93.4示例94修改賬戶密碼接口94.1接口地址94.2參數(shù)定義94.3提交響應94.4提交響應值104.5示例10本文檔主要定了短信平臺對用戶開放的主要接口和定義。1 普通短信發(fā)送用戶可通過HTTP的GET和POST方式提交短信

2、發(fā)送請求。1.1 短信提交地址短信可以提交不超過50000個手機號碼，每個號碼用英文逗號間隔。URL地址為：http:/url:port/manyousms/sendsms。注：其中IP:PORT為服務部署的地址和端口。 GET請求http:/ip:port/manyousms/sendsms?account=test&password= test&mobilescontent=當前驗證碼是：12345【滿友科技】1.2 參數(shù)定義序號參數(shù)說明1account必填參數(shù)。用戶賬號2password必填參數(shù)。用戶密碼3mobiles必填參數(shù)。合法的手機號碼，號碼間用英文逗號

3、分隔4content必填參數(shù)。短信內(nèi)容，短信內(nèi)容長度不能超過585個字符。使用URL方式編碼為UTF-8格式。短信內(nèi)容超過70個字符（企信通是60個字符）時，會被拆分成多條，然后以長短信的格式發(fā)送。5response返回值1.3 短信提交響應用戶短信通過web請求提交到服務器后，服務器返回響應碼，響應碼的格式如下： codetype ： ,sendmsgid: 1.3.1 格式說明短信提交響應分為兩個，第一個為響應狀態(tài)，第二個為服務器給出提交msgid。無論發(fā)送的號碼是多少，一個發(fā)送請求只返回一個msgid。 1.3.2 示例 提交成功codetype :0,sendmsgid:1001030

4、015349555800 響應狀態(tài)為0 表明那個成功提交到服務器；1001030015349555800為返回的sendmsgid，這個供狀態(tài)報告匹配時使用。codetype :101,sendmsgid:1001030015349555800 提交失敗本示例表明用戶提交失敗，返回錯誤碼為101，服務器端并未返回msgid。1.3.3 響應狀態(tài)值說明代碼說明0提交成功101無此用戶102密碼錯103提交過快（提交速度超過流速限制）104系統(tǒng)忙（因平臺側(cè)原因，暫時無法處理提交的短信）105敏感短信（短信內(nèi)容包含敏感詞）106消息長度錯（536或50000或200或=0）109無發(fā)送額度（該用戶可

5、用短信數(shù)已使用完）110不在發(fā)送時間內(nèi)111超出該賬戶當月發(fā)送額度限制112產(chǎn)品無對應的通道115自動審核駁回116簽名不合法，未帶簽名（用戶必須帶簽名的前提下）117IP地址認證錯,請求調(diào)用的IP地址不是系統(tǒng)登記的IP地址118用戶沒有相應的發(fā)送權(quán)限119用戶已過期1.4 注意事項用戶群發(fā)短信如果有審核的限制，則客戶的短信必須經(jīng)過管理人員的審核，審核通過后才能被提交到行業(yè)網(wǎng)關(guān)進行短信實際發(fā)送。用戶群發(fā)短信必須滿足手機號碼最低個數(shù)的限制，低于系統(tǒng)設定的群發(fā)最小手機號碼數(shù)，則該提交請求會被拒絕，響應碼為108。1.5 短信發(fā)送例子http:/ip:port/manyousms/sendsms?a

6、ccount=test&password= test&mobilescontent=【滿友科技】您的注冊驗證碼是：1131.請完成注冊狀態(tài)報告推送如果管理員設置用戶賬戶需要狀態(tài)報告，并且也配置了賬戶的狀態(tài)報告接收地址，則用戶可以接收到其發(fā)送短信的狀態(tài)報告。用戶需提供一個HTTP服務用于接收狀態(tài)報告。58為滿友科技推送報告服務器1.6 參數(shù)定義序號參數(shù)說明1receiver接收狀態(tài)報告驗證的用戶名（不是賬戶名），是按照用戶要求配置的名稱，可以為空2pswd接收狀態(tài)報告驗證的密碼，可以為空3msgid提交短信時平臺返回的msgid，參見1.24re

7、portTime格式Y(jié)YMMDDhhmm，其中YY=年份的最后兩位（00-99），MM=月份（01-12），DD=日（01-31），hh=小時（00-23），mm=分鐘（00-59）5mobile單一的手機號碼6status狀態(tài)報告數(shù)值1.7 狀態(tài)報告值狀態(tài)報告的值即，status后面的數(shù)據(jù)，如下狀態(tài)值(字符串)說明DELIVRD短消息轉(zhuǎn)發(fā)成功EXPIRED短消息超過有效期UNDELIV短消息是不可達的UNKNOWN未知短消息狀態(tài)REJECTD短消息被短信中心拒絕DTBLACK目的號碼是黑名單號碼ERR:104系統(tǒng)忙REJECT審核駁回其他網(wǎng)關(guān)內(nèi)部狀態(tài)1.8 示例http:/pushUrl?r

8、eceiver=admin&pswd=12345&msgid=12345&reportTime=1012241002&mobilestatus=DELIVRD其中，pushUrl為用戶啟動的服務地址。2 短信接收2.1 參數(shù)定義序號參數(shù)說明1receiver接收信息驗證的用戶名（不是賬戶名），是按照用戶要求配置的名稱，可以為空2pswd接收信息服務需驗證的密碼，可以為空3moTime格式Y(jié)YMMDDhhmm，其中YY=年份的最后兩位（00-99），MM=月份（01-12），DD=日（01-31），hh=小時（00-23），mm=分鐘（00-59）4mobile單一的手

9、機號碼5msgMO短信內(nèi)容，文字內(nèi)容使用UTF-8編碼6destcode用戶上行的目的號碼7isems是否為長短信的一部分，1:是，0，不是。不帶該參數(shù)，默認為普通短信8emsheadIsems為1時，本參數(shù)以ASCII碼形式顯示長短信的頭信息。用“,”隔開，分為三個部分，第一部分標識該條長短信的ID（該ID為短信中心生成）；第二部分，表明該長短信的總條數(shù)（pk_total）；第三部分，該條短信為該長短信的第幾條(pk_number)。例如：234,4,1，該短信的ID為234,該長短信的總長度為4條，1，當前為第一條。2.2 示例普通短信：http:/pushMoUrl?receiver=a

10、dmin&pswd=12345&moTime=1208212205&mobiledestcode=1065751600001&msg=hello&destcode=10657109012345EMS短信：http:/pushMoUrl?receiver=admin&pswd=12345&moTime=1208212205&mobiledestcode=1065751600001&msg=hello&destcode=10657109012345&isems=1&emshead=255,5,5其中，pushUrl為用戶啟動的服務地址。3 額度查

11、詢接口3.1 接口地址http:/ip:port/manyousms/getbalance注：其中IP:PORT為服務部署的地址和端口。參數(shù)定義序號參數(shù)說明1account必填參數(shù)。用戶賬號2password必填參數(shù)。用戶密碼3response返回值3.2 提交響應currentBalance:1000currentBalance:-1currentBalance:1000 3.3 提交響應值代碼說明大于0大于0的值為當前余額-1-1為賬號密碼錯誤或者用戶不存在3.4 示例http:/ip:port/manyousms/getbalance?account=111111&password=1234564 修改賬戶密碼接口4.1 接口地址http:/ip:port/manyousms/changepwd4.2 參數(shù)定義序號參數(shù)說明1account賬號2password