滿(mǎn)友科技短信接口文檔

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

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

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

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

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

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

7、portTime格式Y(jié)YMMDDhhmm，其中YY=年份的最后兩位（00-99），MM=月份（01-12），DD=日（01-31），hh=小時(shí)（00-23），mm=分鐘（00-59）5mobile單一的手機(jī)號(hào)碼6status狀態(tài)報(bào)告數(shù)值1.7 狀態(tài)報(bào)告值狀態(tài)報(bào)告的值即，status后面的數(shù)據(jù)，如下?tīng)顟B(tài)值(字符串)說(shuō)明DELIVRD短消息轉(zhuǎn)發(fā)成功EXPIRED短消息超過(guò)有效期UNDELIV短消息是不可達(dá)的UNKNOWN未知短消息狀態(tài)REJECTD短消息被短信中心拒絕DTBLACK目的號(hào)碼是黑名單號(hào)碼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為用戶(hù)啟動(dòng)的服務(wù)地址。2 短信接收2.1 參數(shù)定義序號(hào)參數(shù)說(shuō)明1receiver接收信息驗(yàn)證的用戶(hù)名（不是賬戶(hù)名），是按照用戶(hù)要求配置的名稱(chēng)，可以為空2pswd接收信息服務(wù)需驗(yàn)證的密碼，可以為空3moTime格式Y(jié)YMMDDhhmm，其中YY=年份的最后兩位（00-99），MM=月份（01-12），DD=日（01-31），hh=小時(shí)（00-23），mm=分鐘（00-59）4mobile單一的手

9、機(jī)號(hào)碼5msgMO短信內(nèi)容，文字內(nèi)容使用UTF-8編碼6destcode用戶(hù)上行的目的號(hào)碼7isems是否為長(zhǎng)短信的一部分，1:是，0，不是。不帶該參數(shù)，默認(rèn)為普通短信8emsheadIsems為1時(shí)，本參數(shù)以ASCII碼形式顯示長(zhǎng)短信的頭信息。用“,”隔開(kāi)，分為三個(gè)部分，第一部分標(biāo)識(shí)該條長(zhǎng)短信的ID（該ID為短信中心生成）；第二部分，表明該長(zhǎng)短信的總條數(shù)（pk_total）；第三部分，該條短信為該長(zhǎng)短信的第幾條(pk_number)。例如：234,4,1，該短信的ID為234,該長(zhǎng)短信的總長(zhǎng)度為4條，1，當(dāng)前為第一條。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為用戶(hù)啟動(dòng)的服務(wù)地址。3 額度查

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