一信通短信接口文档文档格式.docx
- 文档编号:21782033
- 上传时间:2023-02-01
- 格式:DOCX
- 页数:14
- 大小:19.88KB
一信通短信接口文档文档格式.docx
《一信通短信接口文档文档格式.docx》由会员分享,可在线阅读,更多相关《一信通短信接口文档文档格式.docx(14页珍藏版)》请在冰豆网上搜索。
一信通
SMS
ShortMessagingService
短消息服务
API
ApplicationProframmingInterface
应用程序编程接口
MO
MessageOriginal
消息上行
MT
MessageTerminal
消息下行
SP
ServiceProvider
服务提供商
CP
ContentProvider
容提供商
1.4参考文献
2.短信
2
2.1http接口
2.1.1消息协议
接口地址:
guangdong.ums86.:
8899/sms/Api/
通过接口提交参数时,参数容必须为GB2312编码,且经过url编码后的容。
例如:
“您好”的url编码为“%C4%FA%BA%C3”
接口返回的容是一些键值对的字符串集合,形式为:
“k1=v1&
k2=v2&
k3=v3…”
返回容中的键值显示为url编码形式,经过url解码后的键值是GB2312编码的字符串。
返回容“result=0&
description=%B7%A2%CB%CD%B3%C9%B9%A6&
faillist=”表示的实际容为“result=0&
description=发送成功&
faillist=”
2.1.2发送短信
功能描述:
短信发送
调用格式:
对guangdong.ums86.:
8899/sms/Api/Send.do进行post
返回格式:
result=&
description=错误描述&
faillist=失败列表
post参数说明:
类别
参数名称
类型
说明
输入
SpCode
string
企业编号
LoginName
用户名称
Password
用户密码
MessageContent
短信容,最大700个字符
UserNumber
手机(多个用”,”分隔),最多1000个
SerialNumber
流水号,20位数字,唯一
ScheduleTime
预约发送时间,格式:
yyyyMMddhhmmss,如‘101’,立即发送请填空
f
提交时检测方式
1---提交中有效的仍正常发出短信,无效的在返回参数faillist中列出
不为1或该参数不存在---提交中只要有无效的,那么所有的都不发出短信,所有的在返回参数faillist中列出
返回值:
返回值
错误描述
发送短信成功
1
提交参数不能为空
2
账号无效,
3
账号密码错误,
4
预约发送时间无效
5
IP不合法,
6
中含有无效或不在规定的号段,
7
容中含有非法关键字、审核不通过、人工审核等
8
容长度超过上限,最大402字符
9
接受过多,最大1000
10
黑用户
11
提交速度太快
12
您尚未订购[普通短信业务],暂不能发送该类信息
13
您的[普通短信业务]剩余数量发送不足,暂不能发送该类信息
14
流水号格式不正确
15
流水号重复
16
超出发送上限
17
余额不足
18
扣费不成功
20
系统错误
21
您只能发送联通的手机,本次发送的手机中包含了非联通的手机
22
您只能发送移动的手机,本次发送的手机中包含了非移动的手机
23
您只能发送电信的手机,本次发送的手机中包含了非电信的手机
实际返回容为“result=0&
description=发送成功”
2.1.3回执接口
短信回执
调用方式:
ftp
文本文件
ftp服务信息:
ftp地址
guangdong.ums86.
端口
返回文本文件格式:
文件名:
arrive_000139_25288_00f_6
一行容:
SPID=197258MESSAGEID=910320f1ID=2432901361CALLMDN=2501MDN=RESULT=0DESC=DELIVRDARRIVE_TIME=402
Java解析这行的方法
//解析一行记录
publicstaticPropertiesparse(Stringline){
StringparsePattern="
([^=\t]+)=([^\t]*)"
;
Matcherm=Ppile(parsePattern).matcher(line);
Propertiesresult=newProperties();
while(m.find()){
Stringkey=m.group
(1).trim();
Stringvalue=m.group
(2).trim();
result.put(key.toUpperCase(),value);
}
returnresult;
}
如果要获取取接受短信的则使用:
Stringmdn=(String)result.get("
MDN"
);
即可
其他字段类似方式
2.1.4剩余短信条数查询
剩余短信条数查询接口
对guangdong.ums86.:
8899/sms/Api/SearchNumber.do进行post
返回值:
2.1.5回复容接口
将上行回复的容通过http协议进行post到企业方
url由企业方提供,然后对该url进行post,post的格式为xml,格式如下:
<
packet>
<
reply>
mdn>
/mdn>
callmdn>
111<
/callmdn>
msg>
回复容测试<
/msg>
replytime>
2012-01-0100:
00:
00<
/replytime>
/reply>
/packet>
返回格式为xml,格式如下:
returncode>
0<
/returncode>
mdn
手机
callmdn
接入号
msg
回复容
replytime
回复时间
接收成功
2.2Webservice接口
2.2.1消息协议
guangdong.ums86.:
8899/sms_hb/services/Sms?
wsdl
2.2.2发送短信
利用webservice客户端进行http请求
SmsResponse
SmsRequest请求参数说明:
In0
In1
In2
In3
短信容,最大402个字符
In4
In5
In6
yyyyMMddhhmmss,如‘101’,立即发送请填空
In7
In8
保留
SmsResponse返回值:
2.2.3回执接口
利用webservice客户端进行http请求
ReportResponse
ReportRequest请求参数说明:
ReportResponse返回值:
out
回执结果,每条回执按分号隔开,每个字段按逗号隔开,每条回执共包含3个字段,第1个字段为流水号,第2个字段为被发送的手机,第3个字段为回执结果,0表示成功,其他值表示失败
实际返回容为“001,,0;
001,,0;
001,,0;
”
2.2.4上行回复容查询接口
上行回复容查询
ReplyResponse
ReplyRequest请求参数说明:
ReplyResponse返回值:
输出
result
返回码
confirm_time
回复时间,格式yyyy-MM-ddHH:
mm:
ss
replys
reply数组
多个relpy对象组成
成功
reply的属性值
callMdn
用户手机号
message
reply_time
2.2.5上行回复容确认接口
ReplyConfirmResponse
ReplyConfirmRequest请求参数说明:
上行回复容查询接口返回的时间,格式:
yyyy-MM-ddHH:
ReplyConfirmResponse返回值:
时间格式不正确,格式为:
2.2.6容审核
AuditingResponse
AuditingRequest请求参数说明:
AuditingResponse返回值:
短信容审核通过
容中含有非法关键字,关键字按逗号隔开
需要人工审核
description=短信容审核通过”
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 一信通 短信 接口 文档
![提示](https://static.bdocx.com/images/bang_tan.gif)