SDK通用版接口调用说明.docx
- 文档编号:16899660
- 上传时间:2023-07-19
- 格式:DOCX
- 页数:14
- 大小:25.78KB
SDK通用版接口调用说明.docx
《SDK通用版接口调用说明.docx》由会员分享,可在线阅读,更多相关《SDK通用版接口调用说明.docx(14页珍藏版)》请在冰点文库上搜索。
SDK通用版接口调用说明
SDK通用版接口调用说明
请仔细阅读信息安全责任保证条款
安全信息责任条款
本人/本公司在使用本软件过程中,将严格遵守国家相关法律、法规、保证本公司信息发布的安全,并切实做到:
(1)建立健全本公司信息发布的内部保障制度、信息安全保密制度、用户信息安全管理制度,建立健全本公司信息安全责任制度和信息发布的审批制度,严格审查本公司产品所发布信息。
(2)严格遵守《互联网信息服务管理办法》,对用户编辑的信息内容进行把关,保证信息内容的健康、合法。
(3)明确本企业的客户群和客户范围,所有通讯受众必须是自愿且明确同意接受企业服务。
(4)若发送未经用户允许的信息等所造成的影响、投诉等一切损失与本软件版权方无关、由本人/本公司承担全部责任;同时,本人/本公司也应承担若因此给本软件版权方造成的全部损失。
(5)不利用本软件制作、复制、发布、传播含有下列内容的信息:
✧反对宪法所确定的基本原则的;
✧危害国家安全,泄露国家秘密,颠覆国家政权,破坏国家统一的;
✧损坏国家荣誉和利益的;
✧煽动民族仇恨、民族歧视,破坏民族团结的;
✧破坏国家民族宗教政策,宣扬邪教和封建迷信的;
✧散布谣言,扰乱社会秩序,破坏社会稳定的;
✧散布淫秽、色情、赌博、暴力、凶杀、恐怖或者教唆犯罪的;
✧侮辱或者诽谤他人,侵害他人合法权益的;
✧含有法律、行政法规禁止的其他内容的;
(6)自信息发布六个月内不修改删除信息发送日志内容,日志记录的备份应至少保持6个月以上,在国家机关进行依法查询时,予以提供。
(7)若发现本公司所发布的信息明显属于上述第(5)款所列内容,保证立即停止传输,并向国家有关机关报告。
(8)对本公司所发布的信息一时难以辨别是否属于以上所列内容之一的,应报相关主管部门审核同意后再发布。
(9)对客户的个人信息保密,未经客户同意不得向他人泄漏,但法律规定的除外。
本人/本公司保证:
在使用本软件进行信息发布活动中,服从监督和管理;若未做到上述一至八条,本人/本公司愿意承担由此引起的一切法律责任,并接受相应的处罚。
注意:
发送之前,序列号一定需要先注册,序列号注册了才可以使用发送短信。
1Webservice接口
1.1webservice返回集合对照表
返回值
返回值说明
问题描述
-2
帐号/密码不正确
1.序列号未注册2.密码加密不正确3.密码已被修改4.序列号已注销
-4
余额不足支持本次发送
余额不足
-5
数据格式错误
只能自行调试了。
或与技术支持联系
-6
参数有误
看参数传的是否均正常,请调试程序查看各参数
-7
权限受限
该序列号是否已经开通了调用该方法的权限
-8
流量控制错误
-9
扩展码权限错误
该序列号是否已经开通了扩展子号的权限,把ext这个参数置空。
-10
内容长度长
单字节不能超过1000个字符,双字节不能超过500个字符
-11
内部数据库错误
-12
序列号状态错误
序列号是否被禁用
-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.1mdsmssend 普通短信
参数名称
说明
是否必须有值
备注
sn
软件序列号
是
格式XXX-XXX-XXX-XXXXX
pwd
密码
是
md5(sn+password)32位大写密文
mobile
手机号
是
必填(支持10000个手机号,建议<=5000)多个英文逗号隔开
Content
内容
是
支持长短信(详细请看长短信扣费说明),URLUTF8编码
Ext
扩展码
否
例如:
123(默认置空)
stime
定时时间
否
例如:
2010-12-2916:
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-1916:
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.2mdgxsend个性短信
参数名称
说明
是否必须有值
备注
sn
软件序列号
是
格式XXX-XXX-XXX-XXXXX
pwd
密码
是
md5(sn+password)32位大写密文
mobile
手机号
是
必填(支持10000个手机号,建议<=5000)多个英文逗号隔开
Content
内容
是
支持长短信(详细请看长短信扣费说明),URLUTF8编码
Ext
扩展码
否
例如:
123(默认置空)
stime
定时时间
否
例如:
2010-12-2916:
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多线程群发普通短信
:
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-2916:
27:
03(置空表示立即发送)
Rrid
唯一标识
否
接口返回值,最长18位,只支持数字。
msgfmt
内容编码
否
0:
ASCII串。
3:
短信写卡操作。
4:
二进制信息。
空或15:
含GB汉字
函数返回值:
String(唯一标识,即当前发送短信批次的唯一标识,和rrid对应,如为空则返回系统生成的rrid)
sn即您注册时的序列号,pwd需要MD5(SN+pwd)加密,取32位大写。
示例:
:
8061/mdsmssend.ashx?
sn=SDK-OFT-010-XXXXX&pwd=D86555F4EA11EFFA57E8F7DF7AAFFD3F&mobile=137****1021&content=要发送的短信的内容【签名】&ext=&stime=&rrid=&msgfmt=
3.2多线程群发个性短信
:
8061/mdgxsend.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
手机号
是
必填(建议一次最多提交1000个)
Content
内容
是
内容通过小逗号与手机号一一对应好URLUTF8编码
Ext
扩展码
否
例如:
123(默认置空)
Stime
定时时间
否
例如:
2010-12-309:
23:
20(置空表示立即发送)
Rrid
唯一标识
否
接口返回值,最长18位,只支持数字
msgfmt
内容编码
否
0:
ASCII串。
3:
短信写卡操作。
4:
二进制信息。
空或15:
含GB汉字
函数返回值:
String(唯一标识,即当前发送短信批次的唯一标识,和rrid对应,如为空则返回系统生成的rrid,此处的rrid和mdsmssend发送的rrid用法相同,此方法用于发送多条内容不相同手机号多个的情况)
示例:
:
8061/mdgxsend.ashx?
sn=SDK-OFT-010-XXXXX&pwd=D86555F4EA11EFFA57E8F7DF7AAFFD3F&mobile=137****1021,137****1022&content=测试1【签名】,测试2【签名】&ext=&stime=&rrid=&msgfmt=
需要注意:
1、手机号以英文逗号隔开
2、发送内容若含有小逗号,整条内容URLUTF8编码编码后,以英文逗号隔开,个数和手机号个数一致
3、扩展码可以为空,单个,或多个(以英文逗号隔开,个数和手机号个数一致)
4、定时时间可以为空,单个,或多个(以英文逗号隔开,个数和手机号个数一致)
4发送说明
4.1做单发说明
(每次提交只有一个手机号)时,十分钟之内,只能提交8条如果需要发送大量的单条信息并且内容不相同,请参考mdgxsend的方法;
4.2做群发说明
(提交内容相同)时,请参看mdsmssend的使用方法,禁止连续一条一条的提交.
4.3编码说明
接口所有方法都是utf-8,提交时请进行相应的转换。
4.4长短信说明
一次提交内容最大是1000字节500汉字此时出现长短信的概念.
4.5长短信扣费说明
如果一次提交小于等于70字符系统会默认为一条短信发出扣费一条
如果大于70字符系统会默认为长短信处理此时扣费按67字符扣一条所以198字符是67*3扣费3条对方如果手机支持长短信则收到一条如果不支持长短信则收到四条(建议内容不超过500字符);纯单字节是140字节一条,超过140字节会按做是67字节一条进行扣费。
如果提交的内容里面既有单字节,又有双字节,则按照双字节计费,即一个英文视为一个汉字
4.6个性短信和普通短信的区别
单发:
个性方法和普通发送发送是一致的,直接给手机号和内容传值就可以的;
群发:
普通方法:
内容相同,手机号不同的,多个手机号中间以英文的逗号分隔。
个性方法:
内容不同,手机号不同的,多个内容和多个手机号中间以英文的逗号分隔,内容条数和手机号个数要求一一对应.
主地址:
:
8061/webservice.asmx
备地址:
:
8061/webservice.asmx
这些地址都是标准的webservice地址,C#,Java客户可以按照自己熟悉的方式去解析
或者
主地址:
:
8061/webservice.asmx?
wsdl
备地址:
:
8061/webservice.asmx?
wsdl
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- SDK 通用版 接口 调用 说明