第二章、賬號(hào)余額接口

獲取短信賬號(hào)的余額（短信條數(shù)=余額*10）。

2.1 請(qǐng)求地址

2.2 參數(shù)說明

示例（實(shí)際對(duì)接請(qǐng)參考《1.3 接口對(duì)接規(guī)范》）：

http(s)://*:*/service/httpService/httpInterface.do?method=getAmount&username=JSM001&password=123&veryCode=456

2.3返回值

<?xml version="1.0" encoding="UTF-8" ?>

    
    0		--返回狀態(tài)值：成功返回0 失敗返回：失敗代碼
    5000	--當(dāng)status為0時(shí)，會(huì)出現(xiàn)該屬性
    

   {"status":"0","account":"735"}

第三章 短信發(fā)送接口

支持普通短信/模板短信/定時(shí)短信發(fā)送，賬號(hào)接口發(fā)送最大速率20條/s，根據(jù)客戶實(shí)際業(yè)務(wù)發(fā)送量可以申請(qǐng)?zhí)崴佟?em>普通短信需人工審核。定時(shí)短信需人工審核，審核通過且到達(dá)定時(shí)發(fā)送間才發(fā)送，在未到達(dá)定時(shí)發(fā)送時(shí)間允許聯(lián)系客服撤銷。模板短信免審，短信模板需要事先登陸客戶端申請(qǐng)報(bào)備并審核通過，短信3-5秒收到，所有行業(yè)短信（業(yè)務(wù)通知\驗(yàn)證碼）優(yōu)先采用模板短信發(fā)送，以免影響短信時(shí)效性。

3.1 請(qǐng)求地址

{API基路徑}/service/httpService/httpInterface.do

method參數(shù)說明：{API基路徑}/service/httpService/httpInterface.do?method=sendMsg&code=utf-8

Utf8編碼：

{API基路徑}/service/httpService/httpInterface.do?method=sendUtf8Msg

GBK編碼

{API基路徑}/service/httpService/httpInterface.do?method=sendGbkMsg

2.2 參數(shù)說明

1 發(fā)送普通短信示例（需要人工審核）：

http://*:*/service/httpService/httpInterface.do?method=sendMsg&username=JSM001&password=123&veryCode=456&mobile=15951977097&content=您好！您本次驗(yàn)證碼為：174687，請(qǐng)勿告知他人&msgtype=1&code=gbk

2 發(fā)送定時(shí)短信示例：

http://*:*/service/httpService/httpInterface.do?method=sendMsg&username=JSM001&password=123&veryCode=456&mobile=15951977097&content=您好！您本次驗(yàn)證碼為：174687，請(qǐng)勿告知他人&msgtype=1&code=gbk&sendtime=20150501093030

3 發(fā)送模板短信示例：

登錄綜合信息管理系統(tǒng)客戶端后,菜單：短信中/短信模版，詳細(xì)操作流程請(qǐng)查看《綜合信息管理系統(tǒng)_使用手冊(cè)(客戶端).docx》，如客戶定義的編號(hào)為JSM4001-0001模板短信為：

尊敬的@1@您好,您在江蘇美圣網(wǎng)站（gushi788.cn），注冊(cè)的手機(jī)驗(yàn)證碼為@2@，請(qǐng)?jiān)隍?yàn)證頁面及時(shí)輸入。

http://*:*/service/httpService/httpInterface.do?method=sendMsg&username=JSM001&password=123&veryCode=456&mobile=15951977097&tempid=JSM4001-000&content=@1@=李先生,@2@=928371&msgtype=2&code=gbk

發(fā)送短信內(nèi)容：【江蘇美圣】尊敬的李先生你好,您在江蘇美圣網(wǎng)站（gushi788.cn），注冊(cè)的手機(jī)驗(yàn)證碼為928371，請(qǐng)?jiān)隍?yàn)證頁面及時(shí)輸入。

Content變量為模版中各變量對(duì)應(yīng)的變量值，多個(gè)變量以英文逗號(hào)隔開：content=@1@=李先生,@3@=928371。

測(cè)試注意事項(xiàng)：

1、正式賬號(hào)發(fā)送模板短信都為免審，直接轉(zhuǎn)發(fā)至運(yùn)營(yíng)商下發(fā)。

2、測(cè)試賬號(hào)發(fā)送模板短信，若模板變量值不包含中文則免審；若模板變量值中包含中文則上審核平臺(tái)；

3、發(fā)送常用語短信模板（無變量的模板），content傳遞空值，即“content=”后面不賦值，直接連接下一個(gè)參數(shù)。如：&content=&msgtype=2&tempid=模板編號(hào)

3.3返回值

<?xml version="1.0" encoding="UTF-8" ?>
<sms>
    <mt>
        <status>0</status>
        <msgid>816f333305664fb9bdd8c1bc96ae12b8</msgid>
    </mt>
</sms>

{
	"status": "0",
	"msgid": "d7cd217727894a2ab6a818d75180959a,91a63c911d114f19bc25d8649d869fdb"
}

<?xml version="1.0" encoding="UTF-8" ?>

    
    0
        
    816f33336ae12b1,830c96ae12b2, 816f3338c6ae12b3
    

四、狀態(tài)報(bào)告接口

獲取短信狀態(tài)報(bào)告接口，只能獲取當(dāng)天短信的狀態(tài)報(bào)告，每次調(diào)用只查詢未被獲取的狀態(tài)報(bào)告。訪問頻率：建議控制在1-3分鐘調(diào)用一次

4.1 請(qǐng)求地址

{API基路徑}/service/httpService/httpInterface.do

4.2參數(shù)說明

示例（實(shí)際對(duì)接請(qǐng)參考《1.3 接口對(duì)接規(guī)范》）：

http://*:*/service/httpService/httpInterface.do?method=queryReport&username=JSM40001&password=123456&veryCode=123456

4.3返回值

        <?xml version="1.0" encoding="UTF-8" ?>
        <sms>
            <rpt>
                <mobile>1595****097</mobile>        <!--手機(jī)號(hào)碼-->
                <msgid>7506751276725633025</msgid>	<!--消息ID ,對(duì)應(yīng)發(fā)送的消息id-->
                <status>MA:0006</status>		    <!--狀態(tài)報(bào)告，DELIVRD-成功，其他-失敗-->
                <time>2015-06-08 11:21:46</time>	<!--報(bào)告時(shí)間-->
                <extno></extno>						<!--擴(kuò)展碼-->
            </rpt>
            <rpt>
                <mobile>1595****097</mobile>
                <msgid>7506751276725633026</msgid>
                <status>MA:0006</status>
                <time>2015-06-08 11:21:46</time>
                <extno></extno>
            </rpt>
            <rpt>
                <mobile>1595****097</mobile>
                <msgid>7507418680283693057</msgid>
                <status>DELIVRD</status>
                <time>2015-06-08 11:59:37</time>
                <extno></extno>
            </rpt>
        </sms>
    

        var a= {
            "status": "0",
            "rpts": [
                {
                    "mobile": "18120130706",
                    "msgid": "d239bbe3bba24163b27066caef635829",
                    "status": "DELIVRD",
                    "time": "2021-04-12 13:44:20",
                    "extno": ""
                },
                {
                    "mobile": "18120130706",
                    "msgid": "d7cd217727894a2ab6a818d75180959a",
                    "status": "DELIVRD",
                    "time": "2021-04-12 15:15:57",
                    "extno": ""
                }
            ]
        }
    

4.4 錯(cuò)誤返回值

    <?xml version="1.0" encoding="utf-8" ?>
        <sms>
        <mt>
            <status>104</status>
        </mt>
    </sms>

{
	"status": "104",
}

五、上行回復(fù)接口

獲取短信狀態(tài)報(bào)告接口，只能獲取當(dāng)天上行回復(fù)短信，每次調(diào)用只查詢未被獲取的上行回復(fù)短信告。 訪問頻率：建議控制在1-3分鐘調(diào)用一次，具體根據(jù)客戶實(shí)際業(yè)務(wù)設(shè)置。

5.1 請(qǐng)求地址

{API基路徑}/service/httpService/httpInterface.do

5.2參數(shù)說明

示例（實(shí)際對(duì)接請(qǐng)參考《1.3 接口對(duì)接規(guī)范》）：

http://*:*/service/httpService/httpInterface.do?method=queryMo&username=test&password=123&veryCode=456

5.3返回值

<?xml version="1.0" encoding="utf-8" ?>
<sms>
    <mo>
    <mobile>15951****97</mobile>				<!--手機(jī)號(hào)碼-->
        <recvcode>106905994140001</recvcode>		<!--接受號(hào)碼-->
        <content>江蘇美圣信息技術(shù)有限公司</content><!--回復(fù)內(nèi)容-->
        <time>2015-04-02 22:12:11</time>			 <!--接收時(shí)間-->
    </mo>
    <mo>
        <mobile>15951****97</mobile>				<!--對(duì)應(yīng)的手機(jī)號(hào)碼-->
        <recvcode>106905994140001</recvcode>		<!--接受號(hào)碼-->
        <content>4006000699</content>				<!--回復(fù)內(nèi)容-->
        <time>2014-04-03 08:12:11</time>			<!--接收時(shí)間-->
    </mo>
</sms>

{
	"status": "0",
	"mos": [
		{
			"mobile": "1812***706",
			"recvcode": "106905994540001",
			"content": "收到",
			"time": "2021-04-12 15:49:19"
		}
	]
}

4.4錯(cuò)誤返回值

<?xml version="1.0" encoding="utf-8" ?>
<sms>
    <mt>
        <status></status>
    </mt>
</sms>

五、常用狀態(tài)報(bào)告碼