第二章、賬號余額接口

獲取短信賬號的余額（短信條數=余額*10）。

2.1 請求地址

2.2 參數說明

示例（實際對接請參考《1.3 接口對接規范》）：

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

2.3返回值

<?xml version="1.0" encoding="UTF-8" ?>
<sms>
<mt>
    <status>0</status>		--返回狀態值：成功返回0 失敗返回：失敗代碼
    <account>5000</account>	--當status為0時，會出現該屬性
</mt>
</sms>

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

第三章 短信發送接口

支持普通短信/模板短信/定時短信發送，賬號接口發送最大速率20條/s，根據客戶實際業務發送量可以申請提速。普通短信需人工審核。定時短信需人工審核，審核通過且到達定時發送間才發送，在未到達定時發送時間允許聯系客服撤銷。模板短信免審，短信模板需要事先登陸客戶端申請報備并審核通過，短信3-5秒收到，所有行業短信（業務通知\驗證碼）優先采用模板短信發送，以免影響短信時效性。

3.1 請求地址

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

method參數說明：{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 參數說明

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

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

2 發送定時短信示例：

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

3 發送模板短信示例：

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

尊敬的@1@您好,您在江蘇美圣網站（www.tunyosh.cn），注冊的手機驗證碼為@2@，請在驗證頁面及時輸入。

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

發送短信內容：【江蘇美圣】尊敬的李先生你好,您在江蘇美圣網站（www.tunyosh.cn），注冊的手機驗證碼為928371，請在驗證頁面及時輸入。

Content變量為模版中各變量對應的變量值，多個變量以英文逗號隔開：content=@1@=李先生,@3@=928371。

測試注意事項：

1、正式賬號發送模板短信都為免審，直接轉發至運營商下發。

2、測試賬號發送模板短信，若模板變量值不包含中文則免審；若模板變量值中包含中文則上審核平臺；

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

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
    

四、狀態報告接口

獲取短信狀態報告接口，只能獲取當天短信的狀態報告，每次調用只查詢未被獲取的狀態報告。訪問頻率：建議控制在1-3分鐘調用一次

4.1 請求地址

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

4.2參數說明

示例（實際對接請參考《1.3 接口對接規范》）：

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>        <!--手機號碼-->
                <msgid>7506751276725633025</msgid>	<!--消息ID ,對應發送的消息id-->
                <status>MA:0006</status>		    <!--狀態報告，DELIVRD-成功，其他-失敗-->
                <time>2015-06-08 11:21:46</time>	<!--報告時間-->
                <extno></extno>						<!--擴展碼-->
            </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 錯誤返回值

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

{
	"status": "104",
}

五、上行回復接口

獲取短信狀態報告接口，只能獲取當天上行回復短信，每次調用只查詢未被獲取的上行回復短信告。 訪問頻率：建議控制在1-3分鐘調用一次，具體根據客戶實際業務設置。

5.1 請求地址

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

5.2參數說明

示例（實際對接請參考《1.3 接口對接規范》）：

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>				<!--手機號碼-->
        <recvcode>106905994140001</recvcode>		<!--接受號碼-->
        <content>江蘇美圣信息技術有限公司</content><!--回復內容-->
        <time>2015-04-02 22:12:11</time>			 <!--接收時間-->
    </mo>
    <mo>
        <mobile>15951****97</mobile>				<!--對應的手機號碼-->
        <recvcode>106905994140001</recvcode>		<!--接受號碼-->
        <content>4006000699</content>				<!--回復內容-->
        <time>2014-04-03 08:12:11</time>			<!--接收時間-->
    </mo>
</sms>

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

4.4錯誤返回值

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

五、常用狀態報告碼