联通在信业务开发规范.docx

《联通在信业务开发规范.docx》由会员分享，可在线阅读，更多相关《联通在信业务开发规范.docx（33页珍藏版）》请在三一办公上搜索。

1、联通在信业务开发规范V1.1中国联合通信公司2005年4月2日目 录1.保密说明31.1.保密原则31.2.保密内容32.总则42.1.背景42.2.文档内容42.3.适用范围42.4.解释权与修订权52.5.术语与缩略语52.6.参考文献53.修改说明64.系统边界和接口设计74.1.系统边界74.2.接口原则74.3.接口约束85.与SP的接口85.1.SP接入规范85.1.1 SP及业务资料导入规范85.1.2 SP业务接入规范105.2.SP基本资料同步接口125.3.SP业务资料同步接口145.4.用户业务定购资料同步接口165.5.SP业务定购WEB调用接口175.6.SP业务点播

2、用户确认接口一八1. 保密说明1.1. 保密原则本资料所有权属于中国联合通信有限公司，任何其他公司、个人无论以任何形式获取了本资料，在使用本资料都应遵守以下保密原则：1) 在未经中国联合通信有限公司授权许可下，不得以任何形式使用本资料；2) 不得传播本资料信息；3) 不得恶意复制、散发本资料。4) 但是不限制合作公司或个人在双方协议基础上，即中国联合通信有限公司授权许可下，正常的使用本资料，包括在授权许可下，在公司内部其他部门阅取、复制、使用本资料信息，或者是和第三方公司、个人共同享用本资料信息。1.2. 保密内容本资料的保密内容包括：1) 在双方协议的基础上，中国联合通信有限公司提供的资料，

3、包括在正式场合下提供的资料，以及在特定场合下提供的正式和非正式资料和信息；2) 在中国联合通信有限公司许可下，从中国联合通信有限公司获取的资料和信息；3) 从其他途径获取，但未经中国联合通信有限公司授权许可的本资料信息。本资料的保密内容不包括：1) 中国联合通信有限公司已经公开或者即将公开的资料信息；2) 经中国联合通信有限公司授权许可后，可以传播的资料信息；3) 在未知本资料信息的情况，自主开发的信息；4) 在接受本协议前已经获取的信息。2. 总则2.1. 背景目前联通在信网络及SP在信业务管理平台基本运行正常，业务发展前景良好，各服务提供商和内容提供商经过一段时间的整合，业务已经开始大幅回

4、升。现在联通业务进一步好转，新增SP/CP越来越多，为了更好的服务各SP/CP,对全国性联通在信业务部分流程进行优化，实现对SP的有效管理，提高用户服务质量，促进联通在信的良性发展。2.2. 文档内容本文主要规定了中国联合通信有限公司的全国性联通在信业务SP管理系统（以下简称SPMS）录入SP资料的接口规范。2.3. 适用范围本文主要用于中国联合通信有限公司全国性联通在信业务SP管理系统的建设与管理。用于指导联通总部、分公司和联通在信业务提供商业务建设的研制、开发和实施。本文适用于SP/CP、SPMS系统建设厂家和联通公司的管理及技术人员等。2.4. 解释权与修订权本文由中国联通制定、审核并发

5、布，起草单位为中国联通增值业务部。本文将根据市场发展需要适时进行修改，其修改权和解释权属于中国联通增值业务部。2.5. 术语与缩略语缩略语全称说明SPService Provider业务提供者SMGShort Message Gateway短消息网关SMSCShort Message Service Center短消息中心SMPPShort Message Peer to Peer短消息点对点协议SGIPShort message Gateway Interface Protocol短消息网关接口协议MOMobile Original移动用户发送短消息MTMobile Terminal移动用户

6、接收短消息SPSMGSP SMG联通在信全国性SP集中网关2.6. 参考文献n 短消息业务联网协议1.2版n 短消息业务联网规范1.2版n 点对点短消息协议 SMPP3.4n 中国联通SP管理系统业务鉴权协议n 中国联合通信有限公司全国性联通在信业务SP管理系统外部接口规范3. 修改说明序号版本号修改人修改日期修改内容4. 接口设计4.1. 接口原则为了保证SPMS系统与其它相关系统方便、可靠地通过接口进行数据交换与业务处理，接口规范应满足如下原则： 接口具有普遍的适应性； 使用简单、快捷的方式实现SPMS与其它相关系统的接口； 接口应充分考虑SPMS与其它相关系统的应用扩展情况； 保证接口数

7、据在SPMS与其它相关系统的一致性； 接口数据能够方便的形成，并能在被接口方顺利地导入； 在接口数据交互过程中，应具有数据传送和接收传送后的确认过程； 在满足功能要求的前提下，使接口数据量最少； 接口数据传输控制策略可靠且完善； 具有可靠的接口数据出错处理机制。4.2. 接口约束n XML文件中，编码方式为UTF-8；n FTP传输ASCII文件时，编码方式为GB-2312；5. SP资料导入接口5.1. SP接入规范5.1.1 SP及业务资料导入规范A. 已接入到“联通在信”的SP已接入到“联通在信”平台并向用户提供短信业务的SP，需要以文件形式一次性将SP的基本资料及全部业务资料同步到联通

8、SP管理平台，SP管理平台鉴权中心根据同步过来的基本信息和业务信息对MO/MT消息进行鉴权，未同步过来的业务将不能通过业务鉴权，由此造成的业务损失由SP自行负责。SP基本资料同步接口参见5.2节。SP业务资料同步接口参见5.3节。B. 新接入到“联通在信”的SP新申请接入到“联通在信”到SP，通过SP管理门户提供的SP自服务门户进行电子化接入，主要流程如下：1) SP预约联通业务部门，提交业务申请及资质审查表。2) 联通业务部门初审SP资料，给SP分配SP自服务门户登陆帐号和密码。3) SP用联通分配的用户名和密码登陆自服务门户。4) SP在自服务门户填写接入资料，提交接入申请。5) 联通业务

9、操作人员在系统管理门户查询SP接入申请，检查、审核SP接入资料，也可通过其它途径对SP进行审核，对符合条件的SP设置为“初审通过”，给SP分配企业代码、接入号、密钥等资源。6) 联通业务主管人员在系统管理门户查询状态为“初审通过”的SP接入资料，对SP进行终审，审核通过后该SP即为接入状态。7) SP通过自服务门户添加业务信息，提交业务接入申请。8) SP接入后，SP可在自服务门户暂停本SP的接入，接入暂停后该SP提供的所有服务均被停止；SP自行暂停后，可在自服务门户进行恢复。9) SP接入后，如SP业务不规范、投诉严重等原因，联通业务管理人员可通过系统管理门户暂停该SP的接入，SP不能自行进

10、行恢复。10) SP可在自服务门户申请接入注销，从SP提交申请注销开始，该SP提供的所有服务均停止。联通业务管理人员确认SP注销后，该SP的信息接入被删除，SP要开通业务需要按接入流程重新进行申请。11) SP接入后，如SP业务不规范、投诉严重等原因，联通业务管理人员可通过系统管理门户注销该SP的接入，注销后不能恢复，SP要开通业务需要按接入流程重新进行申请。C. SP新申请开通的业务1) SP接入成功后，可登陆自服务门户进行业务接入。2) SP操作员在自服务门户中录入业务信息，包括命令字、业务代码、资费方式、业务介绍、操作说明等信息。3) 业务信息录入后，提交业务接入申请（一次可提交多个业务

11、接入申请）。4) 联通业务管理人员在系统管理门户审核SP的业务接入申请信息，联系SP进行业务测试，业务测试通过后可同意业务的接入申请，审核通过后的业务进行正常状态；审核或测试不通过的业务拒绝接入。5) SP可在自服务门户进行业务的暂停/恢复操作，也可注销业务。6) 联通业务管理人员可在自服务门户对SP的业务进行暂停、恢复或注销操作，联通业务管理人员暂停SP业务后，SP不能在自服务门户自行恢复业务。5.1.2 SP业务接入规范接入到“联通在信”平台的SP，可向用户提供基于短信的点播和定制服务，不得随意向用户发送广告信息，业务接入必须遵循如下规范：u 所有业务的接入均需通过联通的审批，SP必须向联

12、通提供正确的业务点播/定制/退订命令字、业务代码、资费信息、操作说明等信息，业务测试及审批通过后方可向用户提供服务。u SP需遵守国家法律，不得提供任何反动、色情、封建、迷信等内容的服务，一旦违例将被吊销服务资格并追究法律责任。u SP不得随意向用户发送广告或其它形式的垃圾短信，不得进行大规模的短信群发，违例将被降低信用等级，严重违例的SP将被注销其服务资格。u SP可通过短信点播/定制的方式或网上点播/定制的方式向用户提供服务。u SP提供的任何定制服务，必须向用户同时提供明确的退订界面，方便用户进行业务退订，不提供退订功能的业务不能接入到“联通在信”平台。u SP在网上提供的点播、定制服务

13、，必须先使用户进行手机注册或绑定，注册或绑定成功后，下发密码通知短信给用户，用户使用注册密码登录网上社区后方能进行点播或定制业务，即SP必须先确定用户身份后才能提供服务。A命令字与业务代码的关系命令字与业务代码由SP自行制定，在一个SP内，业务代码是唯一的，一个点播类业务唯一对应一个点播命令字，一个订制类业务唯一对应一个订制命令字和一个退订命令字，退订服务不收费。对同一种业务，如短信新闻，SP可同时提供点播和定制服务，两种服务资费标准不一样，这种情况下，SP需提供如下所示命令字与业务代码：业务命令字业务代码业务类型退订命令字资费说明新闻DBXWXW0001点播0.1元/条新闻DZXWXW000

14、2订制TDXW5元/月每天2条B订制通知短信对于订制类业务，无论用户通过手机短信发起订制，还是在网上进行订制，订制关系都同时保存在SP管理系统和SP系统。订制流程如下：u 用户发起业务订制请求；u 鉴权中心收到订制消息鉴权请求，生成预定购关系，向用户下发订制确认短信，用户回复确认短信，鉴权中心将用户订制请求发给SP；u SP处理成功用户订制请求后，向用户下发订制通知短信；u 鉴权中心根据SP的订制成功通知短信生成正式的用户订制记录，将通知短信下发给用户。根据以上订制流程可知，最后的订制成功通知短信至关重要，是鉴权中心生成正式订制关系的依据，所以SP必须在用户订制成功后，及时下发订制成功通知短信

15、。订制类业务的计费以SP管理系统中的订制关系为准，如包月业务，SP定时下发包月计费短信，SP管理系统鉴权中心根据本地的订制关系对消息进行鉴权，鉴权失败的消息被拦截。C用户在SP网上社区注册或进行手机绑定SP在网上提供的点播、定制服务，必须先使用户进行手机注册或绑定，注册或绑定成功后，下发密码通知短信给用户，用户使用注册密码登录网上社区后方能进行点播或定制业务，即SP必须先确定用户身份后才能提供服务。使用手机进行网上社区注册或手机绑定时，为了SPMS端确认用户身份和进行密码通知短信的鉴权，要求SP对用户注册采用与业务点播一致的处理流程，即使用点播确认码的用户，参见接口5.6。D手机短信点播SP业

16、务用户使用手机短信点播SP业务，鉴权中心截获MO消息，生成唯一的LinkID，将LinkID加到SGIP Deliver包的Reserve字段后转发给SP，SP下发对应的MT消息时必须将这个LinkID带到Submit包的Reserve字段，鉴权中心根据LinkID对点播产生的MT消息进行鉴权，LinkID不能匹配的消息认为是非法消息而被拦截。E网上点播SP业务为了SPMS端确认用户身份和进行点播消息进行鉴权，SP必须调用SPMS提供的点播调用接口机制，点播确认码由SPMS生成通过短信下发给网上点播的用户手机，参见接口5.6。F手机短信订制/退订业务用户通过手机短信进行业务订制，采用确认短信的

17、机制，由鉴权中心向用户下发确认短信，用户回复确认后，SPMS和SP系统处理订制订请求，SPMS和SP系统的用户订制关系保存同步。用户通过手机短信进行业务退订，不采用确认短信机制。鉴权中心收到退订业务请求后，将该用户的订制关系解除，然后将退订请求转发给SP，SP可向用户下发退订成功通知短信。G网上订制/退订SP业务用户在网上订制业务，采用确认短信的方式，由鉴权中心向用户下发订制确认短信，用户回复后，SPMS和SP系统处理订制订请求，SPMS和SP系统的用户订制关系保存同步，参见接口5.5。用户通过在网站上进行业务退订，不采用确认短信机制。鉴权中心收到退订业务请求后，将该用户的订制关系解除，然后将

18、退订请求转发给SP，SP可向用户下发退订成功通知短信。H用户订制业务短信的鉴权用户订制成功SP业务后，SP根据业务规则向用户下发MT业务消息，鉴权中心根据该用户在SPMS端的订制关系对MT消息进行鉴权，订制关系不正确的MT消息将被拦截。5.2. SP基本资料导入接口u 发起方：SP(一个SP一条记录)u 接收方：SPMSu 接口协议：FTP/HTTP FTP/EMAILu 接口形式：XML文件u 同步时间：已经接入到联通在信的SP，可通过XML文件形式一次性将SP的基本信息同步给SP管理系统。（SP也可不使用该接口，而直接登录SP管理系统的SP自服务门户，以手工录入的方法将SP基本信息提交给S

19、P管理系统。）u 文件命名：SPBI + 5位SP企业代码 + 8位时间 + 4位序号.XML 如：SPBI30165200401010001.XMLu 文件内容：文件以XML格式存储，XML文件中所有字段的类型定义为String型，XML文件属性定义如下：序号字段名最大长度（字节）字段含义说明1CorpID10SP的企业代码不能为空2SpNumber21SP的接入号码不能为空, 一个SP最多可有4个接入号，多接入号情况下以该字段值逗号分隔，如9771,9772,9773（目前只开放一个接入号）3ShortName32SP简称不能为空4SpChName100SP中文名称不能为空5SpEnNam

20、e100SP英文名称不能为空6CorpType2公司类型不能为空0-国营 1-集体2-民营 3-私营4-中外合资5-外商独资7CreateDate10公司成立时间不能为空，格式：YYYY-MM-DD8StockFlag2是否上市0-NO 1-YES9ArtificialPerson32法人代表名不能为空10ChiefOfficer32公司总经理/总裁名不能为空11TotalMember10公司员工数不能为空12RegisterFund10注册资金（元人民币）不能为空一三Introduction120SP介绍不能为空14WebAddress80SP网站地址可填空一五ServiceDesc120S

21、P主营业务介绍不能为空16ProvinceCode3SP接入省份省代码不能为空，参考6.117AreaCode32SP接入城市不能为空,参考6.2一八TeleSvcLicense64电信信息服务许可证编号可填空19TeleSvcLicensedBy100电信信息服务许可证颁发单位可填空20License64营业执照号不能为空21LicensedBy100主管登记机关不能为空22DealInScope120业务经营范围不能为空23BankName64SP开户银行可填空24BankAccount32银行帐号可填空25Address64公司地址不能为空26ZipCode10邮编不能为空27Phone

22、Num20SP公司电话不能为空28FaxNum20SP传真号码不能为空29DisputationNum20SP投诉电话不能为空30EffectiveDate10合约起始时间不能为空，格式：YYYY-MM-DD31ExpireDate10合约终止时间不能为空，格式：YYYY-MM-DD32ChargeUser16负责人姓名不能为空33ChargeUserDesc32负责人职务不能为空34ChargeTelNumber20负责人固定电话不能为空35ChargeMobilePhone20负责人移动电话不能为空36ChargeEmail80负责人EMAIL不能为空37ContactName16联系人姓

23、名不能为空38ContactUserDesc32联系人职务不能为空39ContactTelNumber20联系人固定电话不能为空40ContactMobilePhone20联系人移动电话不能为空（必须为联通）41ContactEmail80联系人EMAIL不能为空（必须如意邮箱，由联通分配）42RegisterDate10注册时间不能为空，格式：YYYY-MM-DD43AccesssDate10接入时间不能为空，格式：YYYY-MM-DDXSD文件定义如下：5.3. SP业务资料同步接口u 发起方：SPu 接收方：SPMSu 接口协议：FTP/EMAILu 接口形式：文本文件u 同步时间：已经

24、接入到联通在信的SP，需通过文件形式将SP已开通的业务信息同步给SP管理系统，SP管理系统根据已接入的业务资料对MO/MT消息进行鉴权。u 文件命名：SPST 5位SP企业代码 + 8位时间 + 4位序号.TXT如：SPST30165200401010001.TXTu 文件内容：文件采用ASCII文本格式，文件体中一行作为一条记录，每一条记录代表sp的一个业务，记录的属性值按顺序排列，各属性间使用t分隔。各条记录之间用换行符作为分隔。序号字段名最大长度（字节）字段含义说明1SpNumber21SP的接入号码不能为空2ServiceType12业务代码不能填空3ServiceTag12业务代码对应的命令字不能填空定制业务命令字与业务代码之间一一对应。点播业务填写点播的命令字（若某个业