一信通接口规范3.5.0(联通平台)

一信通平台能力接口规范中国联通ConfidentialPage1of21一信通平台能力接口规范UMSFundamentalServiceAPIGuide中国联通2013-04-08一信通平台能力接口规范中国联通ConfidentialPage2of21目录1.前言.......................................................................................................................................................41.1文档概述.................................................................................................................................41.2适用范围.................................................................................................................................41.3缩略词典.................................................................................................................................41.4注意事项.................................................................................................................................42.短信接口定义.......................................................................................................................................52.1HTTP接口..............................................................................................................................52.1.1消息协议..............................................................................................................................52.1.2发送短信..............................................................................................................................52.1.3回执接口..............................................................................................................................62.1.4剩余短信条数查询..............................................................................................................82.1.5上行回复内容查询接口......................................................................................................82.1.6上行回复内容确认接口......................................................................................................92.2WEBSERVICE接口................................................................................................................102.2.1消息协议............................................................................................................................102.2.2发送短信............................................................................................................................102.2.3回执接口............................................................................................................................112.2.4上行回复内容查询接口....................................................................................................122.2.5上行回复内容确认接口....................................................................................................122.2.6内容审核............................................................................................................................13一信通平台能力接口规范中国联通ConfidentialPage3of212.3SOCKET接口..........................................................................................................................142.3.1通信方式............................................................................................................................142.3.2消息定义............................................................................................................................152.3.3常量定义............................................................................................................................20HISTORY...................................................................................................................................................21一信通平台能力接口规范中国联通ConfidentialPage4of211.前言1.1文档概述本规范主要讲了第三方应用系统接入一信通平台的协议要求，协议三大状态和协议指令的格式和响应信息。1.2适用范围本规范描述一信通平台（以下简称UMS）具体的接口协议，供第三方应用系统能够顺利接入一信通短信网关。1.3缩略词典UMSUnifiedMessageSystemAPIApplicationProgrammingInterfaceCPContentProviderMOMessageOriginal消息上行MTMessageTerminal消息下行SMSShortMessageServiceSPServiceProvider1.4注意事项hb.ums86.com指企业使用业务时登录门户的地址，如gd.ums86.com一信通平台能力接口规范中国联通ConfidentialPage5of212.短信接口定义2.1HTTP接口2.1.1消息协议接口地址：发送短信功能描述：短信发送调用格式：对进行post返回格式:result=&description=错误描述&faillist=失败号码列表POST参数说明：类别参数名称类型说明输入SpCodestring企业编号输入LoginNamestring用户名称输入Passwordstring用户密码输入MessageContentstring短信内容,最大700个字符输入UserNumberstring手机号码(多个号码用”,”分隔)，最多1000个号码输入SerialNumberstring流水号，20位数字，唯一输入ScheduleTimestring预约发送时间，格式:yyyyMMddhhmmss,如‘20090901010101’，立即发送请填空输入ExtendAccessNumstring接入号扩展号输入fstring提交时检测方式1---提交号码中有效的号码仍正常发出短信，无效的号码在返回参数faillist中列出不为1或该参数不存在---提交号码中只要有无效的号码，那么所有的号码都不发出短信，所有的号码在返回参数faillist中列出GET：=000001&LoginName=admin&Password=admin&MessageContent=短信内容&UserNumber=18616330318&SerialNumber=&ScheduleTime=&f=1返回值：一信通平台能力接口规范中国联通ConfidentialPage6of21返回值错误描述0发送短信成功1提交参数不能为空2账号无效或未开户3账号密码错误,4预约发送时间格式不正确，应为yyyyMMddHHmmss5IP不合法,6号码中含有无效号码或不在规定的号段,7内容中含有非法关键字,8内容长度超过上限，最大402字符9接受号码过多，最大100011提交速度太快12您尚未订购[普通短信业务]，暂不能发送该类信息13您的[普通短信业务]剩余数量发送不足，暂不能发送该类信息14流水号格式不正确15流水号重复16超出发送上限（操作员帐户当日发送上限）17余额不足18扣费不成功20发送失败24账户状态不正常25账户权限不足26需要人工审核28发送内容与模板不符29扩