中国电信短信增值业务开发规范VWord下载.docx
《中国电信短信增值业务开发规范VWord下载.docx》由会员分享,可在线阅读,更多相关《中国电信短信增值业务开发规范VWord下载.docx(12页珍藏版)》请在冰豆网上搜索。
缩略语
英文解释
中文解释
AO
ApplicationOriginate
应用发起
AT
ApplicationTerminated
应用终止
CDR
ChargingDataRecord
计费数据记录
ISAG
IntegratedServiceAccessGateway
综合业务接入网关
NMSC
NationalMobileServiceCenter
综合业务管理平台
MDN
MobileDirectoryNumber
移动用户号码
MO
MobileOriginated
移动发起
MT
MobileTerminated
移动终止
SP
ServiceProvider
服务提供商
SMPP
ShortMessagePointtoPointProtocol
短消息点到点协议
SMGW
SMSGateway
短消息业务接入网关
1.4业务开发上线总体要求
短信SP的业务开发需要包含接口开发和业务逻辑开发两部分。
与短信SP相关的接口有两个:
ISAG与SP平台的接口,NMSC和SP平台的接口。
在业务上线时,需要先将短信SP平台与中国电信的ISAG平台和NMSC平台接口调测通过,才能进行业务逻辑的验证和测试。
中国电信全网短信SP通过中国电信上海分公司的ISAG进行接入。
业务设计规范
1.5长度要求
SMS业务短信内容长度建议不大于335个汉字(670个英文字符)。
长短信由ISAG做切分。
1.6编码要求
SP下发的短消息应采用UCS-2的编码。
1.7业务处理要求
SP的业务应正确处理所有已定义的命令字,如定义了abc*,那么用户上行编辑了abc后面跟任何字符,SP都应给予响应。
即SP可能实际定义了abc1/abc2,用户发送abcy时,SP应反馈对正确命令字的使用帮助。
1.8业务性能要求
要求实时响应的点播型业务,在网络闲时的响应延迟应不超过30秒。
2接口要求
2.1短信业务SP与ISAG之间接口
短信业务SP应采用ISAG接入方式,接口定义参见《中国电信短信业务接口规范V1.0》。
2.2短信业务SP与NMSC之间的接口
3.2.1管理信息通知接口
notifyManagementInfo()
接口调用方向:
NMSC->
SP
触发条件:
SP的业务能力签约、业务、产品、套餐的状态变化时,通知SP该SP的业务能力签约、业务、产品、套餐的编号和状态。
需求约束:
若SP收到业务能力签约注销状态则自行注销基于该业务能力签约发布的所有业务下的产品的定购关系;
若SP收到业务注销状态则自行注销基于该业务发布的所有产品的定购关系;
若SP收到产品/套餐暂停/注销状态则自行暂停/注销该产品/套餐的所有定购关系。
业务能力签约状态变化导致的业务、产品状态变化,仅将业务能力签约状态同步给SP;
业务状态变化导致的产品状态变化,仅将业务状态同步给SP。
SP状态变化及SP状态变化导致的业务能力签约、业务、产品、套餐的状态变化不通知SP。
跨SP的套餐需要将套餐ID通知该套餐内产品的所有SP。
接口交互流程:
图3-1管理信息通知流程图
输入参数:
名称
类型
出现次数
描述
streamingNo
String
1
流水号,可用于调用/提供双方比较接口调用情况
60位,从0开始,用满归零
ID
编号,根据IDType填写
IDType
Integer
0:
ProductID
1:
PackageID
2:
ServiceID
3:
ServiceCapabilityID
status
正常
申请
暂停(IDType为2、3时不可以填本项枚举值)
预注销
4:
注销
输出参数:
将调用的StreamingNo原样返回,保证调用/返回的同步
resultCode
3.2.2定购/使用通知接口
承载协议:
WebService(DocumentStyle)
消息列表:
消息名称
业务使用通知消息
定购关系更新通知消息
3.2.2.1业务执行通知消息
业务使用通知请求(serviceConsumeNotifyReqSyntax)
SP
NMSC获取用户业务执行请求后,发送该消息,SP根据业务情况,决定下发时间。
门户发起业务执行时使用本接口通知SP。
图3-2业务使用通知流程图
域名
userID
String
用户号码
userIDType
MSISDN
PHS
PSTN
PseudoCode
productID
产品标识
linkID
0…1
格式如下:
MMDDHHMMSS+10位随机序列号。
需要SP下发业务,则需要填写本字段
featureStr
使用特征码
3.2.2.2定购关系更新消息
定购关系更新通知(orderRelationUpdateNotifyReqSyntax)
I.定购关系状态变化(正常、暂停、注销)时:
用户定购/退定、用户通过客服要求暂停和暂停恢复,NMSC调用本接口通知SP;
II.套餐定购关系状态变化时,NMSC按产品拆分多次调用本接口将套餐ID和产品ID通知各SP。
图3-3定购关系更新流程图
用户号码
产品标识,
packageID
套餐标识
OPType
定购
暂停
暂停恢复
退定
退定该SP的所有产品和套餐
5:
暂停该SP的所有产品和套餐
输出参数:
3.2.3接口异常处理
实时消息应答不成功,或者超时无应答。
ftp(XMLFile)
同步时间间隔:
可配置
方向:
NMSC生成同步文件,存放在指定目录下,SP按照可以配置的周期从NMSC获取同步文件信息,并负责将该文件删除。
同步参数及回执文件参数定义:
同定购关系更新消息
目录格式如下:
同步数据$HOME/PP/SPID/SP_SUBSCRIPTIONREQ
回执数据$HOME/PP/SPID/SP_SUBSCRIPTIONRSP
文件名生成规则:
同步文件SPSUBSCRIPTIONPPYYYYMMDDHHMMSS.AAA.REQ
回执文件SPSUBSCRIPTIONPPYYYYMMDDHHMMSS.AAA.RSP
说明:
PP
表示归属省代码
SPID
SP编码
YYYY
表示生成此文件的年份
MM
表示生成此文件的月份
DD
表示生成此文件的日期
HH
表示生成此文件的时
表示生成此文件的分
SS
表示生成此文件的秒
AAA
表示文件序列号
同步文件:
参数名
长度
注释
60
timeStamp
DateTime
14
时间戳
orderRelationUpdateInfo
orderRelationUpdateInfoType
1…n
-
SP信息
orderRelationUpdateInfoType数据类型
SUBStreamingNo
20
21
回执文件:
2
.