第二章、账号余额接口

获取短信账号的余额（短信条数=余额*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" ?>

    
    0		--返回状态值：成功返回0 失败返回：失败代码
    5000	--当status为0时，会出现该属性
    

   {"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.jsmsxx.com），注册的手机验证码为@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.jsmsxx.com），注册的手机验证码为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>

五、常用状态报告码