中国移动通信有限公司
ADC平台接口规范
(福建)
福建移动通信公司
文档变更记录
目录
1. 概述 (1)
1.1. 接口概述 (1)
1.2. 文档概述 (1)
1.3. 引用标准 (1)
2. 总体规范 (2)
2.1. 消息结构 (2)
2.1.1. 请求报文 (2)
2.1.2. 应答报文 (4)
2.1.3. Message Body (6)
2.2. 接口方式 (6)
3. ADC管理平台与SI应用系统的接口 (7)
3.1. SSO鉴权接口 (7)
3.1.1. 业务功能 (7)
3.1.2. 业务流程 (7)
3.1.3. 交易报文 (8)
3.1.4. 样例实现 (9)
3.2. SSO心跳接口 (11)
3.2.1. 业务功能 (11)
3.2.2. 业务流程 (11)
3.2.3. 交易报文 (11)
3.2.4. 样例实现 (13)
3.3. 服务开通和修改 (13)
3.3.1. 业务功能 (14)
3.3.2. 业务约束 (14)
3.3.3. 业务流程 (14)
3.3.4. 交易报文 (16)
3.3.5. 样例实现 (19)
3.4. 客户成员管理 (22)
3.4.1. 业务功能 (22)
3.5. SI客户端鉴权和心跳 (26)
3.5.1. 业务功能 (26)
3.5.2. 交易报文 (26)
3.6. SI运行状态及性能检测 (29)
3.6.1. 业务功能 (29)
3.6.2. 交易报文 (29)
3.7. EC成员业务订购申请（BBC） (34)
3.7.1. 业务功能 (34)
3.7.2. 交易报文 (34)
3.8. EC成员业务订购申请异步回执（BBC）.................................................................................... 错误！未定义书签。
3.8.1. 业务功能 ............................................................................................................................. 错误！未定义书签。
3.8.2. 交易报文 ............................................................................................................................. 错误！未定义书签。
3.9. EC成员业务订购（BBC） ......................................................................................................... 错误！未定义书签。
3.9.1. 业务功能 ............................................................................................................................. 错误！未定义书签。
3.9.2. 交易报文 ............................................................................................................................. 错误！未定义书签。
3.10. SI系统告警接口 (37)
4. SI平台能力相关的接口 (48)
4.1. SI能力鉴权接口 (48)
4.1.1. 业务功能 (48)
4.1.2. 交易报文 (49)
4.2. 能力调用接口 (50)
4.2.1. 业务功能 (50)
4.2.2. 交易报文 (51)
5. 接口实现 (54)
5.1. 实现机制 (54)
5.2. ADC提供的接口 (55)
5.3. SI系统提供的接口 (55)
5.4. 参数解释 (55)
5.5. 错误码 (59)
6. 文件接口 (62)
6.1. 文件的发送和获取 (62)
6.2. 文件检验 (62)
6.3. 业务统计数据接口 (63)
5.3.1文件命名规范 (63)
5.3.2文件格式说明 (63)
6.4. 业务统计数据对帐接口 (67)
5.4.1文件命名规范 (68)
5.4.2文件格式说明 (68)
6.5. 黑白名单同步............................................................................................................................. 错误！未定义书签。
6.5.1. 文件命名规范...................................................................................................................... 错误！未定义书签。
6.5.2. 文件格式说明...................................................................................................................... 错误！未定义书签。
6.6. 话单上传 (71)
6.7. SI应用指标上报 (73)
6.8. FTP服务器配置 (75)
7. 附录 (76)
7.1. 企业扩展信息域列表 (76)
7.2. 业务扩展信息域列表 (80)
7.3. 扩展资料编码 (82)
7.3.1. 资料/受理信息编码 (82)
7.3.1.1. 基本资料编码 (82)
7.3.1.2. 扩展资料编码 (84)
7.4. 行业类型编码 (87)
8. SI方接口实现补充注意事项 (93)
8.1. SI数据强制覆盖原则 (93)
8.2. SI接口调用超时控制 (93)
8.3. SI应答报文格式 (94)
5. 文件接口 (37)
5.1 文件的发送和获取 (37)
5.2 文件检验 (37)
5.3 业务统计数据接口 (37)
5.4 业务统计数据对帐接口 (40)
5.5 业务统计报表接口 (41)
5.6 FTP服务器配置 (43)
1.概述
1.1.接口概述
ADC管理平台是本省SI应用的接入点，根据规划，ADC需要与SI应用系统进行信息交换与同步，表1概要说明了ADC管理平台与SI应用系统间的接口操作的内容。
1.2.文档概述
本文的后续部分将分别描述这些接口的功能、流程、属性和接口报文格式。
1.3.引用标准
[1]中国移动通信集团公司《省BOSS与业务管理平台（业务平台）接口规范（暂行）》（V1.1.0）
[2]中国移动通信集团公司《全网行业应用业务规范》
[3]中国移动通信集团公司《中国移动一级BOSS系统接口规范-全网行业应用-SMS业务单行本-IAGW-M部分2.0.0》
[4] 《中国移动一级BOSS系统接口规范V1.4.5》
[5] 网站集团业务接口协议（动力100与BOSS的接口规范）
2.总体规范
总体规范定义传输协议、报文结构，具体如下。
2.1.消息结构
每个交易消息(包括请求和应答)有一个是名字（Message Name），交易消息以XML格式表达的，根据XML的定义，每个XML文件需要有特定的Root Tag（根标记），在本规范中，用消息名作为根节点，根节点下包括两个部分：Message Header(消息头)与Message Body (消息体，交易业务内容)。其中，Message Header用于存储交易请求以及应答的公共部分和消息的控制数据，而Message Body作为消息体，包含交易请求和应答的业务数据。
在本文档中以表格的形式表示XML格式，以下为表格中对元素约束（出现次数）的表示方法的描述：
另外，报文格式中“F”指固定长度，“V”表示变长。
2.1.1.请求报文
ADC与SI系统接口请求报文各个字段解释如下表。SvcCont是报文体的内容，以XML的格式表达，作为报文头的最后一个信息，与报文头一起传送，其他信息是报文头信息，作为标识、控制等信息。
ADC与SI应用系统接口请求报文各个字段解释如下表。
ADC管理平台SI接口业务代码表:
2.1.2.应答报文
ADC与SI应用系统接口应答报文各个字段解释如下表。
SvcCont内容有可能为空，在进行应用拨测的时候ADC平台会发送SvcCont节点为空的报文。SI系统返回报文格式必
须正确，报文内容在这种情况下可以返回错误。
中国移动通信公司
2.1.
3. Message Body
Message Body 为交易请求以及应答的内容，以XML 格式存储，在交易报文传输时作为Message Header 的一个元素“SvcCont ”和Header 一起传输。
2.2. 接口方式
ADC 与SI 平台主要采用WebService 方式，接口协议使用SOAP 协议；部分接口采用文件方式，采用FTP 协议。
。
中国移动通信公司
3.
ADC 管理平台与SI 应用系统的接口
3.1. SSO 鉴权接口
3.1.1. 业务功能
用户使用SI 应用系统之前，首先需要登录ADC 平台。登录成功后，ADC 平台为用户生成一个Token （令牌）；同时用户可以使用其订购的所有SI 应用，用户点击应用链接时，系统将用户Token 传送到SI 应用系统，为实现单点登录，SI 应用系统需要请求ADC 平台对该Token 进行统一鉴权。ADC 平台在鉴权响应中将Token 对应的用户个人信息和权限信息（可能为空）返回到SI 应用系统。
token 传递的方式：参数和 POST-----采用URL 中的参数方式，参数名称是：token 例如：https://https://www.doczj.com/doc/c415364728.html,?token=xxxxxxxxxxxxx 用https 传送，为了我们联调方便暂时我们使用http 传送
3.1.2. 业务流程
ADC 平台单点登录流程如下：
1．用户输入帐号和密码登录到ADC 平台，ADC 平台为用户产生Token ； 2．用户点击SI 应用系统链接，ADC 平台将用户Token 发送给SI 应用系统；
3． SI 应用系统请求ADC 平台对用户Token 鉴权（确认Token 的合法性-是否ADC 产生的，获取用户信息）；
4． ADC 平台返回鉴权响应，将Token 对应的用户信息和用户权限信息发送给SI 应用系统。
说明：Token 在传递的过程中要加密。
中国移动通信公司
3.1.3. 交易报文
(1) 请求报文：
Message Name ：AuthenRequest ； Message Header ：见前面定义； Message Body 如下：
(2) 应答报文：
Message Name ：AuthenResponse ； Message Header ：见前面定义； Message Body 如下：
中国移动通信公司
3.1.
4. 样例实现
Asp 调用WebServices 实例：
SSO 鉴权接口(C#实现,WebServices 通过代理类来实现)
中国移动通信公司
3.2.SSO心跳接口
3.2.1.业务功能
为实现用户的单点登录，ADC平台必须能够感知到用户当前是否处于存活状态。用户登录到SI应用系统以后，ADC 平台无法确定用户是否在线，默认情况下，一定时间（如30分钟）后，ADC平台将会自动杀死用户的进程。所以SI应用系统必须定时调用该接口通知ADC平台更新用户的存活期，以保证用户的Token在用户由SI应用系统中返回到ADC平台后仍然有效，可以继续访问其他SI应用系统的功能。
3.2.2.业务流程
流程如下：
1．用户登录到SI应用系统通过ADC平台统一鉴权。
2．SI应用系统定时（如8分钟）向ADC平台发送心跳请求。
3．ADC平台刷新用户Token存活期为初始值（如30分钟）。
4．ADC平台发送心跳响应结果到SI应用系统（如Token不存在或刷新失败等。）
说明：消息体在传递过程中加密。
3.2.3.交易报文
(1)请求报文：
Message Name：PulseRequest；
Message Header：见前面定义；
Message Body如下：
(2)应答报文：
Message Name：PulseResponse；Message Header：见前面定义；Message Body如下：
3.2.
4.样例实现
SSO心跳接口(C#实现)
3.3.服务开通和修改
对于已经上架的SI产品，当有客户订购时，BOSS处理完订购关系后，将开通指令发给ADC，ADC根据SI标识通知SI应用平台完成开通。
由于每个产品可能包括多个服务，这些服务可能来自不同的SI，BOSS在处理开通时，首先进行拆解，分成独立的SI 服务，生成单个服务开通指令，然后单个或成批送给ADC。
对于已经开通的服务，可以进行修改。
3.3.1.业务功能
由业务描述可知，ADC的主要功能是将从BOSS获得的服务开通信息进行纪录，并转换成规定的消息格式后，向SI 应用系统发送。
ADC平台业务功能如下：
1、获取服务开通信息
2、生成消息，发送。
SI应用系统业务功能如下：
1、获取服务开通信息消息，按照企业要求进行开通处理。
3.3.2.业务约束
1、业务开放范围
本业务面向中国移动SI用户。本功能是后台处理。
2、其它说明
本规范仅描述ADC平台与SI应用系统间的接口操作，包括其功能、流程和相关交易的接口报文定义。
3.3.3.业务流程
客户定购SI产品开通流程如下：
1、EC客户从BOSS系统定购SI产品，如移动办公、企信通；
2、获取产品分类目录，并生成客户订单；
3、订单管理模块拆分订单，记录定购关系，并读取产品的服务配置，生成服务开通工单送统一接口平台；
4、统一接口平台生成开通指令，送往ADC;
5、ADC记录相应企业信息、并通知SI平台做实际服务开通
就接口而言，发起方和落地方受理流程如下。
发起方系统受理流程：
本流程是后台处理流程。
1、ADC接收从BOSS发来的开通指令；
2、ADC将服务开通信息封装成规定的消息格式；
3、ADC调用接口将消息发送给SI系统。
落地方系统受理流程
落地方受理是系统的后台处理过程。
1、落地方（SI）接收来自ADC的服务开通消息；
2、SI系统处理消息，按照企业内部的业务流程进行处理
3、将开通服务确认告知发起方。