SDK通用版接口调用说明
目录
1 请仔细阅读信息安全责任保证条款 2
1.1 安全信息责任条款 2
1.2 注意事项： 3
1 Webservice接口 3
1.1 webservice返回集合对照表 3
2、多线程webservice接口 4
2.1 mdgxsend 个性短信 4
3、多线程http接口 8
3.1 多线程发普通短信 8
3.2 多线程发个性短信 9
请仔细阅读信息安全责任保证条款
安全信息责任条款
本人/本公司在使用本软件过程中，将严格遵守国家相关法律、法规、保证本公司信息发布的安全，并切实做到：
（1） 建立健全本公司信息发布的内部保障制度、信息安全保密制度、用户信息安全管理制度，建立健全本公司信息安全责任制度和信息发布的审批制度，严格审查本公司产品所发布信息。
（2） 严格遵守《互联网信息服务管理办法》，对用户编辑的信息内容进行把关，保证信息内容的健康、合法。
（3） 明确本企业的客户和客户范围，所有通讯受众必须是自愿且明确同意接受企业服
务。
（4） 若发送未经用户允许的信息等所造成的影响、投诉等一切损失与本软件版权方无关、由本人/本公司承担全部责任；同时，本人/本公司也应承担若因此给本软件版权方造成的全部损失。
（5） 不利用本软件制作、复制、发布、传播含有下列内容的信息：
✧ 反对宪法所确定的基本原则的；
✧ 危害国家安全，泄露国家秘密，颠覆国家政权，破坏国家统一的；
✧ 损坏国家荣誉和利益的；
✧ 煽动民族仇恨、民族歧视，破坏民族团结的；
✧ 破坏国家民族宗教政策，宣扬和封建迷信的；
✧ 散布谣言，扰乱社会秩序，破坏社会稳定的；
✧ 散布淫秽、情、赌博、暴力、凶杀、恐怖或者教唆犯罪的；
✧ 侮辱或者诽谤他人，侵害他人合法权益的；
✧ 含有法律、行政法规禁止的其他内容的；
（6） 自信息发布六个月内不修改删除信息发送日志内容，日志记录的备份应至少保持6个月以上，在国家机关进行依法查询时，予以提供。
（7） 若发现本公司所发布的信息明显属于上述第（5）款所列内容，保证立即停止传输，并向国家有关机关报告。
（8） 对本公司所发布的信息一时难以辨别是否属于以上所列内容之一的，应报相关主管部门审核同意后再发布。
（9） 对客户的个人信息保密，未经客户同意不得向他人泄漏，但法律规定的除外。
本人/本公司保证：在使用本软件进行信息发布活动中，服从监督和管理；若未做到上述一至八条，本人/本公司愿意承担由此引起的一切法律责任，并接受相应的处罚。
注意：发送之前，序列号一定需要先注册，序列号注册了才可以使用。
1 Webservice接口
1.1 webservice返回集合对照表
返回值 | 返回值说明 | 问题描述 |
-2 | 帐号/密码不正确 | 1.序列号未注册2.密码加密不正确3.密码已被修改4.序列号已注销 |
-4 | 余额不足支持本次发送 | 余额不足 |
-5 | 数据格式错误 | 只能自行调试了。或与技术支持联系 |
-6 | 参数有误 | 看参数传的是否均正常,请调试程序查看各参数 |
-7 | 权限受限 | 该序列号是否已经开通了调用该方法的权限 |
-8 | 流量控制错误 | |
-9 | 扩展码权限错误 | 该序列号是否已经开通了扩展子号的权限,把ext这个参数置空。 |
-10 | 内容长度长 | 单字节不能超过1000个字符，双字节不能超过500个字符 |
-11 | 内部数据库错误 | |
-12 | 序列号状态错误 | 序列号是否被禁用 |
url编码和utf8区别-14 | 服务器写文件失败 | |
-17 | 没有权限 | 如发送彩信仅限于SDK3 |
-19 | 禁止同时使用多个接口地址 | 每个序列号提交只能使用一个接口地址 |
-20 | 相同手机号，相同内容重复提交 | |
-22/-21 | Ip鉴权失败 | 提交的IP不是所绑定的IP |
-23 | 缓存无此序列号信息 | |
-601 | 序列号为空，参数错误 | |
-602 | 序列号格式错误，参数错误 | |
-603 | 密码为空，参数错误 | |
-604 | 手机号码为空，参数错误 | |
-605 | 内容为空，参数错误 | |
-606 | ext长度大于9，参数错误 | |
-607 | 参数错误 扩展码非数字 | |
-608 | 参数错误 定时时间非日期格式 | |
-609 | rrid长度大于18,参数错误 | |
-610 | 参数错误 rrid非数字 | |
-611 | 参数错误 内容编码不符合规范 | |
-623 | 手机个数与内容个数不匹配 | |
-624 | 扩展个数与手机个数数 | |
-625 | 定时时间个数与手机个数不匹配 | |
-626 | Rrid个数与手机号个数不一致 | |
2、 多线程webservice接口
地址：
2.1 mdsmssend 普通短信
参数名称 | 说明 | 是否必须有值 | 备注 |
sn | 软件序列号 | 是 | 格式XXX-XXX-XXX-XXXXX |
pwd | 密码 | 是 | md5(sn+password) 32位大写密文 |
mobile | 手机号 | 是 | 必填(支持10000个手机号,建议<=5000)多个英文逗号隔开 |
Content | 内容 | 是 | 支持长短信(详细请看长短信扣费说明)，URLUTF8编码 |
Ext | 扩展码 | 否 | 例如：123（默认置空） |
stime | 定时时间 | 否 | 例如：2010-12-29 16:27:03（置空表示立即发送） |
Rrid | 唯一标识 | 否 | 接口返回值，最长18位,只支持数字。 |
msgfmt | 内容编码 | 否 | 0：ASCII串。3：短信写卡操作。4：二进制信息。空或15：含GB汉字 |
函数返回值：String（唯一标识，即当前批次的唯一标识,和rrid对应，如为空则返回系统生成的rrid）此方法推荐用于大量发.内容相同手机号多个
示例1：
输入参数：
SN= SDK-BBX-010-00001
PWD=3B5D3C427365F40C1D27682D78BB31E0
Mobile:139***404,138***213…………….
Content:测试 【签名】
Ext:21（如果不是网络版，请置空）
Stime:2009-10-19 16:34:00 （如果不需要定时，请置空）
Rrid:123456 （如果填写则系统返回填写内容，如果置空，返回系统生成的rrid）
Msgfmt：(请制空)
输出结果：
XML格式:
文本格式:
123456
示例2
SN= SDK-BBX-010-00001
PWD=3B5D3C427365F40C1D27682D78BB31E0
Mobile:139***404,138***213…………….
Content:测试[签名]
Ext:
Stime:
Msgfmt:
Rrid: 此处为空
输出结果:
XML格式:
文本格式:0916********
2.2 mdgxsend个性短信
参数名称 | 说明 | 是否必须有值 | 备注 |
sn | 软件序列号 | 是 | 格式XXX-XXX-XXX-XXXXX |
pwd | 密码 | 是 | md5(sn+password) 32位大写密文 |
mobile | 手机号 | 是 | 必填(支持10000个手机号,建议<=5000)多个英文逗号隔开 |
Content | 内容 | 是 | 支持长短信(详细请看长短信扣费说明)，URLUTF8编码 |
Ext | 扩展码 | 否 | 例如：123（默认置空） |
stime | 定时时间 | 否 | 例如：2010-12-29 16:27:03（置空表示立即发送） |
Rrid | 唯一标识 | 否 | 接口返回值，最长18位,只支持数字。 |
msgfmt | 内容编码 | 否 | 0：ASCII串。3：短信写卡操作。4：二进制信息。空或15：含GB汉字 |
函数返回值：String （唯一标识，即当前批次的唯一标识,和rrid对应，如为空则返回系统生成的rrid,此处的rrid和mt发送的rrid用法相同,此方法用于发送多条内容不相同手机号多个的情况）
需要注意:
1、手机号以英文逗号隔开
2、发送内容若含有小逗号，整条内容URLUTF8编码编码后，以英文逗号隔开，个数和手机号个数一致
3、扩展码可以为空，单个，或多个（以英文逗号隔开，个数和手机号个数一致）
4、定时时间可以为空，单个，或多个（以英文逗号隔开，个数和手机号个数一致）
返回结果:
XML格式:
示例1：
输入参数：
SN= SDK-BBX-010-00001
PWD=3B5D3C427365F40C1D27682D78BB31E0
Mobile:139***404,138***213
Content: %B2%E2%CA%D41, %B2%E2%CA%D42
Ext:（如果不是网络版，请置空）
Stime: （如果不需要定时，请置空）
Msgfmt：(请制空)
Rrid:123456 （如果填写则系统返回填写内容，如果置空，返回系统生成的rrid）
输出结果：
XML格式:
文本格式:
123456
示例2
SN= SDK-BBX-010-00001
PWD=3B5D3C427365F40C1D27682D78BB31E0
Mobile:139***404,138***213…………….
Content: %B2%E2%CA%D41, %B2%E2%CA%D42
Ext:
Stime:
Msgfmt：
Rrid: 此处为空
输出结果:
XML格式:
文本格式:
0916********
单发两个方法没区别；
发：
普通方法：内容相同，手机号不同的，多个手机号中间以英文的逗号分隔。
个性方法：内容不同，手机号不同的，多个内容和多个手机号中间以英文的逗号分隔，内容条数和手机号个数要求一一对应.
3、 多线程http接口
3.1 多线程发普通短信
info:8061/mdsmssend.ashx?sn=SN&pwd=MD5(sn+password)&mobile=mobile&content=content&ext=&stime=&rrid=&msgfmt=
参数名称 | 说明 | 是否必须有值 | 备注 |
sn | 软件序列号 | 是 | 格式XXX-XXX-XXX-XXXXX |
pwd | 密码 | 是 | md5(sn+password) 32位大写密文 |
mobile | 手机号 | 是 | 必填(支持10000个手机号,建议<=5000)多个英文逗号隔开 |
Content | 内容 | 是 | 支持长短信(详细请看长短信扣费说明)，URLUTF8编码 |
Ext | 扩展码 | 否 | 例如：123（默认置空） |
stime | 定时时间 | 否 | 例如：2010-12-29 16:27:03（置空表示立即发送） |
Rrid | 唯一标识 | 否 | 接口返回值，最长18位,只支持数字。 |
msgfmt | 内容编码 | 否 | 0：ASCII串。3：短信写卡操作。4：二进制信息。空或15：含GB汉字 |
函数返回值：String（唯一标识，即当前批次的唯一标识,和rrid对应，如为空则返回系统生成的rrid）
sn即您注册时的序列号，pwd需要MD5(SN+pwd)加密，取32位大写。
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论