中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

CT

综合业务管理平台ISMP接口规范

-门户接口

中国电信集团公司

中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

目 录

1 2 3 4 5

适用范围 ........................................................................................................................................................... 4 引用标准 ........................................................................................................................................................... 5 缩略语 ................................................................................................................................................................ 6 需求约束 ........................................................................................................................................................... 7 ISMP与用户门户之间的接口 ................................................................................................................. 8 5.1 ISMP与用户门户组网 ........................................................................................................................ 8 5.2 终端信息查询接口 ................................................................................................................................ 8 5.2.1 流程 .................................................................................................................................................... 8 5.2.2 概述 .................................................................................................................................................... 8 5.2.3 消息 .................................................................................................................................................... 9 5.3 功能调用接口 ......................................................................................................................................... 9 5.3.1 用户管理接口 ............................................................................................................................... 10 5.3.2 认证与授权接口 .......................................................................................................................... 16 5.3.3 定购管理接口 ............................................................................................................................... 19 5.4 门户统一配置接口 .............................................................................................................................. 31 5.4.1 终端信息同步接口 ..................................................................................................................... 32 5.4.2 SP信息同步接口 ............................................................................................................................ 39 5.4.3 内容信息同步接口 ..................................................................................................................... 40 5.4.4 内容与产品关系同步接口 ....................................................................................................... 43 5.4.5 业务类别同步接口 ..................................................................................................................... 44 5.4.6 业务信息同步接口 ..................................................................................................................... 45 5.4.7 产品信息同步接口 ..................................................................................................................... 47 5.4.8 套餐信息同步接口 ..................................................................................................................... 49 5.4.9 集团产品信息同步接口 ............................................................................................................ 51 5.4.10 号段信息同步接口 ..................................................................................................................... 52 5.4.11 业务引擎URL信息同步接口 ................................................................................................ 53 5.4.12 回执文件 ........................................................................................................................................ 54 5.4.13 业务小图标同步接口................................................................................................................. 54

附录A. 业务能力编号及业务类型 ........................................................................................................... 55 附录B. 门户结果码定义 .............................................................................................................................. 56

中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

前 言

本规范定义了中国电信综合业务管理平台ISMP（Integrated Service Management Platform）的接口规范，包括ISMP与SS、ISAG、MSNMC、Portal、OCS、IN、运营支撑系统、CP/SP之间的接口。

本规范解释权属于中国电信集团公司。

本规范起草单位：中国电信股份有限公司上海研究院。

本标准主要起草人：韩彬斌，王铮，任华，方燕萍，黄铖斌，杨迪，张亚玫、宋金晶、黄颂尧。

中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

1 适用范围

本规范适用于中国电信综合业务管理平台（ISMP）产品的设计及研发，提供给为中国电信开发制造ISMP的设备供应商。本规范是中国电信各级运营单位进行ISMP招标采购、工程设计、网络运营、管理、维护等方面的技术依据。

中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

2 引用标准

下列文件通过本文的参考而成为本规范的条款。凡是注日期的参考文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本文，凡是不注日期的参考文件，其最新版本适用于本文。 附录A. 《中国电信移动增值业务网络技术体制》 附录B. 《中国电信综合业务管理平台ISMP规范总册》 附录C. 《中国电信综合业务管理平台ISMP设备规范》 附录D. 《中国电信综合业务管理平台ISMP数据规范》

中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

3 缩略语

中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

4 需求约束

1、 所有编码都使用10进制。 2、 所有长度都为建议长度。

中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

5 ISMP与用户门户之间的接口

5.1 ISMP与用户门户组网

用户门户负责业务/产品/套餐展现，为用户提供增值业务自服务通道。用户门户和其归属的ISMP相连。

5.2 终端信息查询接口 5.2.1 流程

图5.12.2 终端能力查询流程示意图

各网元匹配终端能力信息时，首先在本地终端能力信息数据库中匹配终端获取相应的能力信息。若本地数据库中不存在对应该终端的能力信息数据，则各网元触发到归属平台上的终端能力信息HTTP GET请求，并将终端中的Accept和User-Agent字段发送给归属平台。归属平台在本地终端信息数据库中寻找，如无相应的对应关系，查询结束不能获得终端能力信息，不再向更上级ISMP查询。如查到对应关系，则将该本地所存储的终端能力信息XML文件作为HTTP RESPONSE的内容返回给查询的网元，网元将该XML文件存于本地数据库中。

5.2.2 概述

触发条件：当门户在本地终端信息数据库无法匹配到对应的终端类型时，主动向ISMP发起终端信

中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

息查询请求消息，以获得终端相信信息。

承载协议：http。 消息列表：

5.2.3 消息

单次查询请求：

使用HTTP GET http://UaHost消息。

该消息用于向ISMP发起单次异步查询，其中UaHost为归属ISMP的主机域名。该消息参照标准HTTP GET，需要扩展下列Header头：

单次查询响应：

单次查询响应使用HTTP GET RESPONSE消息。

该消息参照标准HTTP GET RESPONSE，如果没有查到对应的终端能力信息，返回成功（代表ISMP正确收到门户的查询申请并成功进行查询处理）和空消息体。如果查询到对应的终端能力信息，向门户返回单次查询后获得的终端能力信息。其中返回的响应消息体为所查询的单个终端能力信息XML文件，该XML文件的格式同终端信息同步文件传送时的XML文件。

5.3 功能调用接口

承载协议：WebService (Document Style),

中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

5.3.1 用户管理接口

5.3.1.1

更改密码: modifyPassword()

接口方向：Portal->ISMP

触发条件：用户在门户发起WEB门户的密码更改请求

需求约束：用户修改密码时必须输入2遍新密码，由门户保证用户输入是否一致。 接口交互流程：

ISMP验证旧密码，保存新密码

图1. 更改密码

消息体定义 输入参数

中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

输出参数

5.3.1.2 重设密码 resetPassword()

接口方向：Portal->ISMP

触发条件：用户在门户发起WEB门户的密码重设请求

需求约束：门户先验证手机与用户的对应关系（验证码），再允许用户重设密码，并调用本接口。 接口交互流程：

中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

图2. 重设密码

消息体定义 输入参数：

输出参数：

中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

5.3.1.3 读取用户信息: readUser()

接口方向：Portal->ISMP

触发条件：门户发起查看基本信息请求

需求约束：用户必须通过认证之后才能读取用户信息。 接口交互流程：

图3. 读取用户信息

消息体定义 输入参数

中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

输出参数

5.3.1.4 修改用户信息： modifyUser()

接口方向：Portal->ISMP

触发条件：用户在门户发起修改基本信息请求

需求约束：用户必须通过门户认证之后才能修改用户信息，仅省门户可以发起该消息。

中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

接口交互流程：

图4. 修改用户信息

消息体定义 输入参数

输出参数

中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

5.3.2 认证与授权接口

5.3.2.1

用户认证: authenticateUser()

接口方向：Portal->ISMP 触发条件：用户登录门户 需求约束：无 接口交互流程：

ISMP校验用户手机号，若用户从WEB接入则还要验证用户密码

图5. 用户认证

消息体定义 输入参数