一信通短信接口文档

上海帜讯信息技术有限公司Page1of122012.02一信通企业信息服务平台接口手册产品名称一信通企业信息服务平台接口手册版本编号2.1.2文档编号发布者发布日期2012-5-10上海帜讯信息技术有限公司Page2of122012.02目录一信通企业信息服务平台...........................................................................................................................11.概述.......................................................................................................................................................31.1编制目的.................................................................................................................................31.2内容概述.................................................................................................................................31.3名称解释.................................................................................................................................31.4参考文献.................................................................................................................................32.短信.......................................................................................................................................................42.1HTTP接口................................................................................................................................42.1.1消息协议..............................................................................................................................42.1.2发送短信..............................................................................................................................42.1.3回执接口..............................................................................................................................52.1.4剩余短信条数查询..............................................................................................................62.1.5回复内容接口......................................................................................................................72.2WEBSERVICE接口....................................................................................................................72.2.1消息协议..............................................................................................................................72.2.2发送短信..............................................................................................................................82.2.3回执接口..............................................................................................................................92.2.4上行回复内容查询接口....................................................................................................102.2.5上行回复内容确认接口....................................................................................................102.2.6内容审核............................................................................................................................11修改历史日期版本作者修改内容评审号更改请求号上海帜讯信息技术有限公司Page3of122012.021.概述1.1编制目的该接口文档手册编写在于描述易派企业信息服务平台UMS（以下简称UMS）具体的接口协议，供第三方系统能够顺利接入一信通短信网关。1.2内容概述本规范主要讲了第三方系统接入短信通系统的协议要求，协议三大状态和协议指令的格式和响应信息。1.3名称解释缩略语英文全名中文全名UMSUnifiedMessageService一信通SMSShortMessagingService短消息服务APIApplicationProframmingInterface应用程序编程接口MOMessageOriginal消息上行MTMessageTerminal消息下行SPServiceProvider服务提供商CPContentProvider内容提供商1.4参考文献上海帜讯信息技术有限公司Page4of122012.022.短信2.1http接口2.1.1消息协议接口地址：通过接口提交参数时,参数内容必须为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发送短信功能描述：短信发送调用格式：对进行post返回格式:result=&description=错误描述&faillist=失败号码列表post参数说明：类别参数名称类型说明输入SpCodestring企业编号输入LoginNamestring用户名称输入Passwordstring用户密码输入MessageContentstring短信内容,最大700个字符输入UserNumberstring手机号码(多个号码用”,”分隔)，最多1000个号码输入SerialNumberstring流水号，20位数字，唯一输入ScheduleTimestring预约发送时间，格式:yyyyMMddhhmmss,如‘20090901010101’，立即发送请填空输入fstring提交时检测方式1---提交号码中有效的号码仍正常发出短信，无效的号码在返回参数faillist中列出上海帜讯信息技术有限公司Page5of122012.02不为1或该参数不存在---提交号码中只要有无效的号码，那么所有的号码都不发出短信，所有的号码在返回参数faillist中列出返回值：返回值错误描述0发送短信成功1提交参数不能为空2账号无效,3账号密码错误,4预约发送时间无效5IP不合法,6号码中含有无效号码或不在规定的号段,7内容中含有非法关键字、审核不通过、人工审核等8内容长度超过上限，最大402字符9接受号码过多，最大100010黑名单用户11提交速度太快12您尚未订购[普通短信业务]，暂不能发送该类信息13您的[普通短信业务]剩余数量发送不足，暂不能发送该类信息14流水号格式不正确15流水号重复16超出发送上限17余额不足18扣费不成功20系统错误21您只能发送联通的手机号码，本次发送的手机号码中包含了非联通的手机号码22您只能发送移动的手机号码，本次发送的手机号码中包含了非移动的手机号码23您只能发送电信的手机号码，本次发送的手机号码中包含了非电信的手机号码实际返回内容为“result=0&description=发送成功”2.1.3回执接口功能描述：短信回执调用方式：ftp返回格式:文本文件上海帜讯信息技术有限公司Page6of122012.02ftp服务信息：参数名称说明ftp地址guangdong.ums86.com端口21返回文本文件格式:文件名:arrive_000139_25288_0000000000000000000f_201107071556一行内容：SPID=197258MESSAGEID=910320f1ID=2432901361CALLMDN=106550270102501MDN=18616330318RESULT=0DESC=DELIVRDARRIVE_TIME=20110707155402Java解析这行的方法//解析一行记录publicstaticPropertiesparse(Stringline){StringparsePattern=([^=\t]+)=([^\t]*);Matcherm=Pattern.compile(parsePattern).matcher(line);Propertiesresult=newProperties();while(m.find()){Stringkey=m.gr