联通在信业务开发规范Word下载.docx
《联通在信业务开发规范Word下载.docx》由会员分享，可在线阅读，更多相关《联通在信业务开发规范Word下载.docx（36页珍藏版）》请在冰豆网上搜索。
SP
ServiceProvider
业务提供者
SMG
ShortMessageGateway
短消息网关
SMSC
ShortMessageServiceCenter
短消息中心
SMPP
ShortMessagePeertoPeer
短消息点对点协议
SGIP
ShortmessageGatewayInterfaceProtocol
短消息网关接口协议
MO
MobileOriginal
移动用户发送短消息
MT
MobileTerminal
移动用户接收短消息
SPSMG
SPSMG
联通在信全国性SP集中网关
2.6.参考文献
⏹《短消息业务联网协议1.2版》
⏹《短消息业务联网规范1.2版》
⏹《点对点短消息协议SMPP3.4》
⏹《中国联通SP管理系统业务鉴权协议》
⏹《中国联合通信有限公司全国性联通在信业务SP管理系统外部接口规范》
3.修改说明
序号
版本号
修改人
修改日期
修改内容
4.接口设计
4.1.接口原则
为了保证SPMS系统与其它相关系统方便、可靠地通过接口进行数据交换与业务处理，接口规范应满足如下原则：
Ø
接口具有普遍的适应性；
使用简单、快捷的方式实现SPMS与其它相关系统的接口；
接口应充分考虑SPMS与其它相关系统的应用扩展情况；
保证接口数据在SPMS与其它相关系统的一致性；
接口数据能够方便的形成，并能在被接口方顺利地导入；
在接口数据交互过程中，应具有数据传送和接收传送后的确认过程；
在满足功能要求的前提下，使接口数据量最少；
接口数据传输控制策略可靠且完善；
具有可靠的接口数据出错处理机制。
4.2.接口约束
⏹XML文件中，编码方式为UTF-8；
⏹FTP传输ASCII文件时，编码方式为GB-2312；
5.SP资料导入接口
5.1.SP接入规范
5.1.1SP及业务资料导入规范
A.已接入到“联通在信”的SP
已接入到“联通在信”平台并向用户提供短信业务的SP，需要以文件形式一次性将SP的基本资料及全部业务资料同步到联通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）联通业务操作人员在系统管理门户查询SP接入申请，检查、审核SP接入资料，也可通过其它途径对SP进行审核，对符合条件的SP设置为“初审通过”，给SP分配企业代码、接入号、密钥等资源。
6）联通业务主管人员在系统管理门户查询状态为“初审通过”的SP接入资料，对SP进行终审，审核通过后该SP即为接入状态。
7）SP通过自服务门户添加业务信息，提交业务接入申请。
8）SP接入后，SP可在自服务门户暂停本SP的接入，接入暂停后该SP提供的所有服务均被停止；
SP自行暂停后，可在自服务门户进行恢复。
9）SP接入后，如SP业务不规范、投诉严重等原因，联通业务管理人员可通过系统管理门户暂停该SP的接入，SP不能自行进行恢复。
10）SP可在自服务门户申请接入注销，从SP提交申请注销开始，该SP提供的所有服务均停止。
联通业务管理人员确认SP注销后，该SP的信息接入被删除，SP要开通业务需要按接入流程重新进行申请。
11）SP接入后，如SP业务不规范、投诉严重等原因，联通业务管理人员可通过系统管理门户注销该SP的接入，注销后不能恢复，SP要开通业务需要按接入流程重新进行申请。
C.SP新申请开通的业务
1）SP接入成功后，可登陆自服务门户进行业务接入。
2）SP操作员在自服务门户中录入业务信息，包括命令字、业务代码、资费方式、业务介绍、操作说明等信息。
3）业务信息录入后，提交业务接入申请（一次可提交多个业务接入申请）。
4）联通业务管理人员在系统管理门户审核SP的业务接入申请信息，联系SP进行业务测试，业务测试通过后可同意业务的接入申请，审核通过后的业务进行正常状态；
审核或测试不通过的业务拒绝接入。
5）SP可在自服务门户进行业务的暂停/恢复操作，也可注销业务。
6）联通业务管理人员可在自服务门户对SP的业务进行暂停、恢复或注销操作，联通业务管理人员暂停SP业务后，SP不能在自服务门户自行恢复业务。
5.1.2SP业务接入规范
接入到“联通在信”平台的SP，可向用户提供基于短信的点播和定制服务，不得随意向用户发送广告信息，业务接入必须遵循如下规范：
◆所有业务的接入均需通过联通的审批，SP必须向联通提供正确的业务点播/定制/退订命令字、业务代码、资费信息、操作说明等信息，业务测试及审批通过后方可向用户提供服务。
◆SP需遵守国家法律，不得提供任何反动、色情、封建、迷信等内容的服务，一旦违例将被吊销服务资格并追究法律责任。
◆SP不得随意向用户发送广告或其它形式的垃圾短信，不得进行大规模的短信群发，违例将被降低信用等级，严重违例的SP将被注销其服务资格。
◆SP可通过短信点播/定制的方式或网上点播/定制的方式向用户提供服务。
◆SP提供的任何定制服务，必须向用户同时提供明确的退订界面，方便用户进行业务退订，不提供退订功能的业务不能接入到“联通在信”平台。
◆SP在网上提供的点播、定制服务，必须先使用户进行手机注册或绑定，注册或绑定成功后，下发密码通知短信给用户，用户使用注册密码登录网上社区后方能进行点播或定制业务，即SP必须先确定用户身份后才能提供服务。
A．命令字与业务代码的关系
命令字与业务代码由SP自行制定，在一个SP内，业务代码是唯一的，一个点播类业务唯一对应一个点播命令字，一个订制类业务唯一对应一个订制命令字和一个退订命令字，退订服务不收费。
对同一种业务，如短信新闻，SP可同时提供点播和定制服务，两种服务资费标准不一样，这种情况下，SP需提供如下所示命令字与业务代码：
业务
命令字
业务代码
业务类型
退订命令字
资费
新闻
DBXW
XW0001
点播
0.1元/条
DZXW
XW0002
订制
TDXW
5元/月
每天2条
B．订制通知短信
对于订制类业务，无论用户通过手机短信发起订制，还是在网上进行订制，订制关系都同时保存在SP管理系统和SP系统。
订制流程如下：
◆用户发起业务订制请求；
◆鉴权中心收到订制消息鉴权请求，生成预定购关系，向用户下发订制确认短信，用户回复确认短信，鉴权中心将用户订制请求发给SP；
◆SP处理成功用户订制请求后，向用户下发订制通知短信；
◆鉴权中心根据SP的订制成功通知短信生成正式的用户订制记录，将通知短信下发给用户。
根据以上订制流程可知，最后的订制成功通知短信至关重要，是鉴权中心生成正式订制关系的依据，所以SP必须在用户订制成功后，及时下发订制成功通知短信。
订制类业务的计费以SP管理系统中的订制关系为准，如包月业务，SP定时下发包月计费短信，SP管理系统鉴权中心根据本地的订制关系对消息进行鉴权，鉴权失败的消息被拦截。
C．用户在SP网上社区注册或进行手机绑定
SP在网上提供的点播、定制服务，必须先使用户进行手机注册或绑定，注册或绑定成功后，下发密码通知短信给用户，用户使用注册密码登录网上社区后方能进行点播或定制业务，即SP必须先确定用户身份后才能提供服务。
使用手机进行网上社区注册或手机绑定时，为了SPMS端确认用户身份和进行密码通知短信的鉴权，要求SP对用户注册采用与业务点播一致的处理流程，即使用点播确认码的用户，参见接口5.6。
D．手机短信点播SP业务
用户使用手机短信点播SP业务，鉴权中心截获MO消息，生成唯一的LinkID，将LinkID加到SGIPDeliver包的Reserve字段后转发给SP，SP下发对应的MT消息时必须将这个LinkID带到Submit包的Reserve字段，鉴权中心根据LinkID对点播产生的MT消息进行鉴权，LinkID不能匹配的消息认为是非法消息而被拦截。
E．网上点播SP业务
为了SPMS端确认用户身份和进行点播消息进行鉴权，SP必须调用SPMS提供的点播调用接口机制，点播确认码由SPMS生成通过短信下发给网上点播的用户手机，参见接口5.6。
F．手机短信订制/退订业务
用户通过手机短信进行业务订制，采用确认短信的机制，由鉴权中心向用户下发确认短信，用户回复确认后，SPMS和SP系统处理订制订请求，SPMS和SP系统的用户订制关系保存同步。
用户通过手机短信进行业务退订，不采用确认短信机制。
鉴权中心收到退订业务请求后，将该用户的订制关系解除，然后将退订请求转发给SP，SP可向用户下发退订成功通知短信。
G．网上订制/退订SP业务
用户在网上订制业务，采用确认短信的方式，由鉴权中心向用户下发订制确认短信，用户回复后，SPMS和SP系统处理订制订请求，SPMS和SP系统的用户订制关系保存同步，参见接口5.5。
用户通过在网站上进行业务退订，不采用确认短信机制。
H．用户订制业务短信的鉴权
用户订制成功SP业务后，SP根据业务规则向用户下发MT业务消息，鉴权中心根据该用户在SPMS端的订制关系对MT消息进行鉴权，订制关系不正确的MT消息将被拦截。
5.2.SP基本资料导入接口
◆发起方：
SP（一个SP一条记录）
◆接收方：
SPMS
◆接口协议：
FTP/HTTPFTP/EMAIL
◆接口形式：
XML文件
◆同步时间：
已经接入到联通在信的SP，可通过XML文件形式一次性将SP的基本信息同步给SP管理系统。
（SP也可不使用该接口，而直接登录SP管理系统的SP自服务门户，以手工录入的方法将SP基本信息提交给SP管理系统。
）
◆文件命名：
SPBI+5位SP企业代码+8位时间+4位序号.XML
如：
SPBI30165200401010001.XML
◆文件内容：
文件以XML格式存储，XML文件中所有字段的类型定义为String型，XML文件属性定义如下：
字段名
最大长度
（字节）
字段含义
1
CorpID
10
SP的企业代码
不能为空
2
SpNumber
21
SP的接入号码
不能为空,一个SP最多可有4个接入号，多接入号情况下以该字段值逗号分隔，如9771,9772,9773（目前只开放一个接入号）
3
ShortName
32
SP简称
4
SpChName
100
SP中文名称
5
SpEnName
SP英文名称
6
CorpType
公司类型
0-国营1-集体
2-民营3-私营
4-中外合资
5-外商独资
7
CreateDate
公司成立时间
不能为空，格式：
YYYY-MM-DD
8
StockFlag
是否上市
0-NO1-YES
9
ArtificialPerson
法人代表名
ChiefOfficer
公司总经理/总裁名
11
TotalMember
公司员工数
12
RegisterFund
注册资金（元人民币）
13
Introduction
120
SP介绍
14
WebAddress
80
SP网站地址
可填空
15
ServiceDesc
SP主营业务介绍
16
ProvinceCode
SP接入省份省代码
不能为空，参考6.1
17
AreaCode
SP接入城市
不能为空,参考6.2
18
TeleSvcLicense
64
电信信息服务许可证编号
19
TeleSvcLicensedBy
电信信息服务许可证颁发单位
20
License
营业执照号
LicensedBy
主管登记机关
22
DealInScope
业务经营范围
23
BankName
SP开户银行
24
BankAccount
银行帐号
25
Address
公司地址
26
ZipCode
邮编
27
PhoneNum
SP公司电话
28
FaxNum
SP传真号码
29
DisputationNum
SP投诉电话
30
EffectiveDate
合约起始时间
31
ExpireDate
合约终止时间
ChargeUser
负责人姓名
33
ChargeUserDesc
负责人职务
34
ChargeTelNumber
负责人固定电话
35
ChargeMobilePhone
负责人移动电话
36
ChargeEmail
负责人EMAIL
37
ContactName
联系人姓名
38
ContactUserDesc
联系人职务
39
ContactTelNumber
联系人固定电话
40
ContactMobilePhone
联系人移动电话
不能为空（必须为联通）
41
ContactEmail
联系人EMAIL
不能为空（必须如意邮箱，由联通分配）
42
RegisterDate
注册时间
43
AccesssDate
接入时间
XSD文件定义如下：
<
?
xmlversion="
1.0"
encoding="
UTF-8"
?
>
xs:
schemaxmlns:
xs="
http:
//www.w3.org/2001/XMLSchema"
elementname="
SPMS"
<
complexType>
<
sequence>
<
elementref="
SpBasicInfo"
maxOccurs="
100000"
/>
/xs:
<
element>
CorpID"
minOccurs="
1"
SpNumber"
ShortName"
SpChName"
SpEnName"
CorpType"
CreateDate"
StockFlag"
ArtificialPerson"
ChiefOfficer"
TotalMember"
RegisterFund"
Introduction"
WebAddress"
0"
ServiceDesc"
ProvinceCode"
AreaCode"
TeleSvcLicense"
TeleSvcLicensedBy"
License"
LicensedBy"
DealInScope"
BankName"
BankAccount"
Address"
ZipCode"
PhoneNum"
FaxNum"
DisputationNum"
EffectiveDate"
ExpireDate"
ChargeUser"
升级会员 