中国电信短信增值业务开发规范V.docx
- 文档编号:3613814
- 上传时间:2022-11-24
- 格式:DOCX
- 页数:12
- 大小:55.96KB
中国电信短信增值业务开发规范V.docx
《中国电信短信增值业务开发规范V.docx》由会员分享,可在线阅读,更多相关《中国电信短信增值业务开发规范V.docx(12页珍藏版)》请在冰豆网上搜索。
中国电信短信增值业务开发规范V
中国电信集团公司发布
中国电信短信增值业务
开发规范
(V1.0)
中国电信股份有限公司
1概述
1.1目的
本规范是对中国电信短信SP业务开发所应遵循的原则之一。
本规范的目的是为了规范服务供应商(SP)在中国电信短信通道上提供的应用服务而制定。
本规范是指导SP进行短信业务开发的原则之一,提供短信服务的SP同时必须遵循《中国电信移动增值业务业务合作管理办法》。
本规范将随着中国电信短信SP业务的发展而进行修订,中国电信将及时把新修订的业务规范通知各服务供应商(SP),各SP应遵循当时的短信增值业务开发规范进行业务开发。
本规范中未涉及到的议题,由中国电信和各SP本着相互尊重、平等互利的原则进行磋商。
本规范自颁发之日起执行。
本规范的解释权归中国电信股份有限公司所有。
1.2适用对象
本规范适用于所有在中国电信短信通道上提供应用服务的服务供应商(SP)。
各服务供应商(SP)应按照当前版本的开发规范来开展业务。
中国电信各省分公司的短信应用服务可参照此规范执行。
1.3相关术语和缩略语
缩略语
英文解释
中文解释
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
String
1
编号,根据IDType填写
IDType
Integer
1
0:
ProductID
1:
PackageID
2:
ServiceID
3:
ServiceCapabilityID
status
Integer
1
0:
正常
1:
申请
2:
暂停(IDType为2、3时不可以填本项枚举值)
3:
预注销
4:
注销
输出参数:
名称
类型
出现次数
描述
streamingNo
String
1
将调用的StreamingNo原样返回,保证调用/返回的同步
resultCode
Integer
1
3.2.2定购/使用通知接口
承载协议:
WebService(DocumentStyle)
消息列表:
消息名称
业务使用通知消息
定购关系更新通知消息
3.2.2.1业务执行通知消息
业务使用通知请求(serviceConsumeNotifyReqSyntax)
接口调用方向:
NMSC->SP
触发条件:
NMSC获取用户业务执行请求后,发送该消息,SP根据业务情况,决定下发时间。
需求约束:
门户发起业务执行时使用本接口通知SP。
接口交互流程:
图3-2业务使用通知流程图
输入参数:
域名
类型
出现次数
描述
streamingNo
String
1
流水号,可用于调用/提供双方比较接口调用情况
60位,从0开始,用满归零
userID
String
1
用户号码
userIDType
Integer
1
0:
MSISDN
1:
PHS
2:
PSTN
3:
PseudoCode
productID
String
1
产品标识
linkID
String
0…1
格式如下:
MMDDHHMMSS+10位随机序列号。
需要SP下发业务,则需要填写本字段
featureStr
String
0…1
使用特征码
输出参数:
名称
类型
出现次数
描述
streamingNo
String
1
将调用的StreamingNo原样返回,保证调用/返回的同步
resultCode
Integer
1
3.2.2.2定购关系更新消息
定购关系更新通知(orderRelationUpdateNotifyReqSyntax)
接口调用方向:
NMSC->SP
触发条件:
I.定购关系状态变化(正常、暂停、注销)时:
用户定购/退定、用户通过客服要求暂停和暂停恢复,NMSC调用本接口通知SP;
II.套餐定购关系状态变化时,NMSC按产品拆分多次调用本接口将套餐ID和产品ID通知各SP。
接口交互流程:
图3-3定购关系更新流程图
输入参数:
域名
类型
出现次数
描述
streamingNo
String
1
流水号,可用于调用/提供双方比较接口调用情况
60位,从0开始,用满归零
userID
String
1
用户号码
userIDType
Integer
1
0:
MSISDN
1:
PHS
2:
PSTN
3:
PseudoCode
productID
String
0…1
产品标识,
packageID
String
0…1
套餐标识
OPType
Integer
1
0:
定购
1:
暂停
2:
暂停恢复
3:
退定
4:
退定该SP的所有产品和套餐
5:
暂停该SP的所有产品和套餐
输出参数:
名称
类型
出现次数
描述
streamingNo
String
1
将调用的StreamingNo原样返回,保证调用/返回的同步
resultCode
Integer
1
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
表示生成此文件的时
MM
表示生成此文件的分
SS
表示生成此文件的秒
AAA
表示文件序列号
同步文件:
参数名
类型
出现次数
长度
注释
streamingNo
String
1
60
流水号,可用于调用/提供双方比较接口调用情况
60位,从0开始,用满归零
timeStamp
DateTime
1
14
时间戳
orderRelationUpdateInfo
orderRelationUpdateInfoType
1…n
-
SP信息
orderRelationUpdateInfoType数据类型
参数名
类型
出现次数
长度
注释
SUBStreamingNo
String
1
60
流水号,可用于调用/提供双方比较接口调用情况
60位,从0开始,用满归零
userID
String
1
20
用户号码
userIDType
Integer
1
1
0:
MSISDN
1:
PHS
2:
PSTN
3:
PseudoCode
productID
String
0…1
21
产品标识,
packageID
String
0…1
21
套餐标识
OPType
Integer
1
1
0:
定购
1:
暂停
2:
暂停恢复
3:
退定
4:
退定该SP的所有产品和套餐
5:
暂停该SP的所有产品和套餐
回执文件:
参数名
类型
出现次数
长度
注释
streamingNo
String
1
60
将调用的StreamingNo原样返回,保证调用/返回的同步
resultCode
Integer
1
2
.
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 中国电信 短信 增值 业务 开发 规范
![提示](https://static.bdocx.com/images/bang_tan.gif)