《中国电信短信增值业务开发规范V》由会员分享，可在线阅读，更多相关《中国电信短信增值业务开发规范V（12页珍藏版）》请在金锄头文库上搜索。
1、保密等级：公开发放中国电信集团公司 发布2008-11-26实施2008-11-26发布中国电信短信增值业务开发规范(V1.0)Q/CTXXXX.1-2008中国电信集团公司技术标准中国电信股份有限公司目 录目 录21概述21.1目的21.2适用对象21.3相关术语和缩略语21.4业务开发上线总体要求32业务设计规范42.1长度要求42.2编码要求42.3业务处理要求42.4业务性能要求43接口要求43.1短信业务SP与ISAG之间接口43.2短信业务SP与NMSC之间的接口4 1 概述1.1 目的本规范是对中国电信短信SP业务开发所应遵循的原则之一。本规范的目的是为了规范服务供应商（SP）在
2、中国电信短信通道上提供的应用服务而制定。本规范是指导SP进行短信业务开发的原则之一，提供短信服务的SP同时必须遵循中国电信移动增值业务业务合作管理办法。本规范将随着中国电信短信SP业务的发展而进行修订，中国电信将及时把新修订的业务规范通知各服务供应商（SP），各SP应遵循当时的短信增值业务开发规范进行业务开发。本规范中未涉及到的议题，由中国电信和各SP本着相互尊重、平等互利的原则进行磋商。本规范自颁发之日起执行。本规范的解释权归中国电信股份有限公司所有。1.2 适用对象本规范适用于所有在中国电信短信通道上提供应用服务的服务供应商（SP）。各服务供应商（SP）应按照当前版本的开发规范来开展业务。
3、中国电信各省分公司的短信应用服务可参照此规范执行。1.3 相关术语和缩略语缩略语英文解释中文解释AOApplication Originate应用发起ATApplication Terminated应用终止CDRCharging Data Record计费数据记录ISAGIntegrated Service Access Gateway综合业务接入网关NMSCNational Mobile Service Center综合业务管理平台MDNMobile Directory Number移动用户号码MOMobile Originated移动发起MTMobile Terminated移动终止SPS
4、ervice Provider服务提供商SMPPShort Message Point to Point Protocol短消息点到点协议SMGWSMS Gateway短消息业务接入网关1.4 业务开发上线总体要求短信SP的业务开发需要包含接口开发和业务逻辑开发两部分。与短信SP相关的接口有两个：ISAG与SP平台的接口，NMSC和SP平台的接口。在业务上线时，需要先将短信SP平台与中国电信的ISAG平台和NMSC平台接口调测通过，才能进行业务逻辑的验证和测试。中国电信全网短信SP通过中国电信上海分公司的ISAG进行接入。2 业务设计规范2.1 长度要求SMS业务短信内容长度建议不大于335个
5、汉字（670个英文字符）。长短信由ISAG做切分。2.2 编码要求SP下发的短消息应采用UCS-2的编码。2.3 业务处理要求SP的业务应正确处理所有已定义的命令字，如定义了abc*，那么用户上行编辑了abc后面跟任何字符，SP都应给予响应。即SP可能实际定义了abc1/abc2，用户发送abcy时，SP应反馈对正确命令字的使用帮助。2.4 业务性能要求要求实时响应的点播型业务，在网络闲时的响应延迟应不超过30秒。3 接口要求3.1 短信业务SP与ISAG之间接口短信业务SP应采用ISAG接入方式，接口定义参见中国电信短信业务接口规范V1.0。3.2 短信业务SP与NMSC之间的接口管理信息通
6、知接口notifyManagementInfo（）接口调用方向：NMSC SP触发条件：SP的业务能力签约、业务、产品、套餐的状态变化时，通知SP 该SP的业务能力签约、业务、产品、套餐的编号和状态。 需求约束：若SP收到业务能力签约注销状态则自行注销基于该业务能力签约发布的所有业务下的产品的定购关系；若SP收到业务注销状态则自行注销基于该业务发布的所有产品的定购关系；若SP收到产品/套餐暂停/注销状态则自行暂停/注销该产品/套餐的所有定购关系。业务能力签约状态变化导致的业务、产品状态变化，仅将业务能力签约状态同步给SP；业务状态变化导致的产品状态变化，仅将业务状态同步给SP。SP状态变化及S
7、P状态变化导致的业务能力签约、业务、产品、套餐的状态变化不通知SP。跨SP的套餐需要将套餐ID通知该套餐内产品的所有SP。接口交互流程：图3-1管理信息通知流程图输入参数：名称类型出现次数描述streamingNoString1流水号，可用于调用提供双方比较接口调用情况位，从开始，用满归零IDString1编号，根据IDType填写IDTypeInteger10：ProductID1：PackageID2：ServiceID3：ServiceCapabilityIDstatusInteger10：正常1：申请2：暂停（IDType为2、3时不可以填本项枚举值）3：预注销4：注销输出参数：名称类
8、型出现次数描述streamingNoString1将调用的StreamingNo原样返回，保证调用返回的同步resultCode Integer1定购/使用通知接口承载协议：WebService（Document Style）消息列表：消息名称业务使用通知消息定购关系更新通知消息业务执行通知消息业务使用通知请求（serviceConsumeNotifyReq Syntax）接口调用方向：NMSC SP 触发条件： NMSC获取用户业务执行请求后，发送该消息，SP根据业务情况，决定下发时间。需求约束：门户发起业务执行时使用本接口通知SP。接口交互流程：图3-2 业务使用通知流程图输入参数：域名类
9、型出现次数描述streamingNoString1流水号，可用于调用提供双方比较接口调用情况位，从开始，用满归零userIDString 1用户号码userIDTypeInteger10：MSISDN1：2：PSTN3：Pseudo CodeproductIDString1产品标识linkIDString01格式如下：MMDDHHMMSS+10位随机序列号。需要SP下发业务，则需要填写本字段featureStrString01使用特征码输出参数：名称类型出现次数描述streamingNoString1将调用的StreamingNo原样返回，保证调用返回的同步resultCode Integer
10、1定购关系更新消息定购关系更新通知（orderRelationUpdateNotifyReq Syntax）接口调用方向：NMSC SP触发条件：I. 定购关系状态变化（正常、暂停、注销）时：用户定购/退定、用户通过客服要求暂停和暂停恢复，NMSC调用本接口通知SP；II. 套餐定购关系状态变化时，NMSC按产品拆分多次调用本接口将套餐ID和产品ID通知各SP。接口交互流程：图3-3 定购关系更新流程图输入参数：域名类型出现次数描述streamingNoString1流水号，可用于调用提供双方比较接口调用情况位，从开始，用满归零userIDString 1用户号码 userIDTypeInte
11、ger10：MSISDN1：2：PSTN3：Pseudo CodeproductIDString01产品标识,packageIDString01套餐标识OPTypeInteger10：定购1：暂停2：暂停恢复3：退定4：退定该SP的所有产品和套餐5：暂停该SP的所有产品和套餐 输出参数：名称类型出现次数描述streamingNoString1将调用的StreamingNo原样返回，保证调用返回的同步resultCode Integer1接口异常处理触发条件：实时消息应答不成功，或者超时无应答。承载协议：ftp（XML File）同步时间间隔：可配置方向： NMSC生成同步文件，存放在指定目录下
12、，SP按照可以配置的周期从NMSC获取同步文件信息，并负责将该文件删除。同步参数及回执文件参数定义：同定购关系更新消息目录格式如下：同步数据$HOME/PP/SPID/SP_SUBSCRIPTIONREQ回执数据$HOME/PP/SPID/SP_SUBSCRIPTIONRSP文件名生成规则：同步文件SPSUBSCRIPTIONPPYYYYMMDDHHMMSS.AAA.REQ回执文件SPSUBSCRIPTIONPPYYYYMMDDHHMMSS.AAA.RSP说明：PP表示归属省代码 SPIDSP编码YYYY表示生成此文件的年份MM表示生成此文件的月份DD表示生成此文件的日期HH表示生成此文件的时
13、MM表示生成此文件的分SS表示生成此文件的秒AAA表示文件序列号同步文件：参数名类型出现次数长度注释streamingNoString160流水号，可用于调用提供双方比较接口调用情况位，从开始，用满归零timeStampDateTime114时间戳orderRelationUpdateInfoorderRelationUpdateInfoType1n-SP信息orderRelationUpdateInfoType数据类型参数名类型出现次数长度注释SUBStreamingNoString160流水号，可用于调用提供双方比较接口调用情况位，从开始，用满归零userIDString 120用户号码 userIDTypeInteger110：MSISDN1：2：PSTN3：Pseudo CodeproductIDString0121产品标识,packageIDString0121套餐标识OPTypeInteger110：定购1：暂停2：暂停恢复3：退定4：退定该SP的所有产品和套餐5：暂停该SP的所有产品和套餐回执文件：参数名类型出现次数长度注释streamingN
