《中国移动通信有限公司ADC平台接口规范》由会员分享，可在线阅读，更多相关《中国移动通信有限公司ADC平台接口规范（16页珍藏版）》请在金锄头文库上搜索。
1、中国移动通信有限公司中国移动通信有限公司 ADC 平台接口规范平台接口规范 (福建福建) 福建移动通信公 司 文档变更记录 序号变更内容说明版本号版本日期执笔人 1创建 1.02014-7-10 郑磊 2修订二级 ec 编码定义为 4 位 1.22004-10-20 郑磊 目 录 1概述概述.1 1.1接口概述1 1.2文档概述1 1.3引用标准1 2总体规范总体规范.2 2.1消息结构2 2.1.1请求报文2 2.1.2应答报文3 2.1.3Message Body.5 2.2接口方式5 3 3ADCADC 管理平台与管理平台与 SISI 应用系统的接口应用系统的接口6 1.1三网合一业务产
2、品订购6 1.1.1业务功能6 1.1.2交易单元6 1.1.3交易报文6 1.2三网合一业务黑白名单同步8 1.2.1业务功能8 1.2.2交易单元8 1.2.3交易报文8 4附录附录.9 4.1归属地市编码9 4.2行业类型编码11 5 5SISI 方接口实现补充注意事项方接口实现补充注意事项15 5.1SI 数据强制覆盖原则.15 5.2SI 接口调用超时控制.15 5. 文件接口文件接口 37 5.1 文件的发送和获取.37 5.2 文件检验.37 5.3 业务统计数据接口 .37 5.4 业务统计数据对帐接口.40 5.5 业务统计报表接口. 41 5.6 FTP 服务器配置.43
3、1概述概述 1.1接口概述接口概述 ADC 管理平台是本省 SI 应用的接入点，根据规划，ADC 需要与 SI 应用系统进行信息交 换与同步，表 1 概要说明了 ADC 管理平台与 SI 应用系统间的接口操作的内容。 表 1 ADC 管理平台与 SI 应用系统间接口一览表 序号序号业务名称业务名称交易名称交易名称 业务业务 发起方发起方 备注备注 1SSO 鉴权SSO 鉴权SI实时 2SSO 心跳接口SSO 心跳接口SI实时 3服务开通和修改服务开通和修改ADC实时 4服务状态变更服务状态变更ADC实时 5客户成员管理客户成员管理ADC业务分配使用 6SI 客户端鉴权和心跳SI 客户端鉴权和心
4、跳SI实时 7业务统计数据接口业务统计数据接口SI文件 8业务统计报表接口业务统计报表接口SI文件 9业务统计数据对帐接口业务统计数据对帐接口ADC文件 10SI 业务状态及性能检测SI 业务状态及性能检测ADC实时 11体验用户 SSO 鉴权接口体验用户 SSO 鉴权接口SI实时 12代理商 SSO 鉴权和心跳代理商 SSO 鉴权和心跳SI实时 13代理商信息查询接口代理信息查询接口SI实时 1.2文档概述文档概述 本文的后续部分将分别描述这些接口的功能、流程、属性和接口报文格式。 1.3引用标准引用标准 1中国移动通信集团公司 省 BOSS 与业务管理平台（业务平台）接口规范（暂行） （V
5、1.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（根标记），在本 规范
6、中，用消息名作为根节点，根节点下包括两个部分：Message Header(消息头)与 Message Body (消息体，交易业务内容)。其中，Message Header 用于存储交易请求以及 应答的公共部分和消息的控制数据，而 Message Body 作为消息体，包含交易请求和应答的 业务数据。 在本文档中以表格的形式表示 XML 格式，以下为表格中对元素约束（出现次数）的表 示方法的描述： 符号含义 ?01，可选项 *0n，可以没有，也可以有多项 +1n，至少有 1 项，也可以有多项 1数字 1，代表必须且只能填 1 项 另外，报文格式中“F”指固定长度，“V”表示变长。 2.1.1
7、请求报文请求报文 ADC 与 SI 系统接口请求报文各个字段解释如下表。SvcCont 是报文体的内容，以 XML 的格 式表达，作为报文头的最后一个信息，与报文头一起传送，其他信息是报文头信息，作为标识、控制等信息。 ADC 与 SI 应用系统接口请求报文各个字段解释如下表。 序 号 父元素 名称 元素名 称 约束类型 长 度 描述取值说明 1HEAD BizCode1String V1 6 消息标志 接口业务代码,5 位,见 ADC 管理平台 SI 接口业务代码表: 2HEADTransID1String V1 6 消息序列号 在发起方唯一标识一个交易的流水号， 系统内唯一 16 位唯一流
8、水 组成方式：”SI”8 位日期6 位唯一 数，每天从 000001 开始，如 SI20060801000001 3HEAD ActionC ode 1IntegerF1动作码1-请求，2-应答 4 HEADTIMEST AMP 1String F1 8 时间戳 系统时间戳,格式为: YYYYMMDDHHmmssnnnn 5 HEAD SIAppID1String V1 6 业务应用标识 标识是哪个 SI 应用系统，每个 SI 系统 约定（分配）一个标识 6 HEAD TestFla g 1IntegerF1测试标记 发起方填写，0：非测试交易，1：测 试交易；测试必须是业务级别，即在同 一个
9、业务流水中所有交易必须具有相同 的测试标记 7 HEAD Dealkin d 1IntegerF1同步异步方式0 同步操作 ，1 异步操作 8 HEAD Version1StringF4 业务内容报文的 版本号 保留字段，对于同一交易应答与请求版 本号始终一致 9 HEAD Priority1Integer 优先级 保留字段，此处填 0 10 HEAD SvcCo nt 1String 请求报文体内容具体业务数据，以 XML 表达 2.1.2应答报文应答报文 ADC 与 SI 应用系统接口应答报文各个字段解释如下表。 序 号 父元素 名称 元素名 称 约束类型 长 度 描述取值说明 1HEAD
10、 BizCode1String V1 6 消息标志 接口业务代码,5 位,见 ADC 管理平台 SI 接口业务代码表: 2HEADTransID1String V3 0 消息序列号同发起方的流水号 3 HEADTIMEST AMP 1String F1 8 时间戳 系统时间戳,格式为 YYYYMMDDHHmmssnnnn 4HEAD ActionC ode 1IntegerF1动作码1-请求，2-应答 5 HEAD SIAppID1String V1 6 业务应用标识 标识是哪个 SI 应用系统，每个 SI 系统 约定（分配）一个标识 6 HEADTestFla g 1IntegerF1测试标
11、记同发起方的请求报文 7 HEAD Dealkin d 1IntegerF1同步异步方式0 同步操作 ，1 异步操作 8 HEAD SvcCon Ver 1StringF4 业务内容报文的 版本号 保留字段，对于同一交易应答与请求版 本号始终一致 9 HEAD Priority1Integer 优先级 保留字段，此处填 0 10 HEADResultCc ode 1String16返回结果代码 0=成功 1=失败 11 HEADResultMs g 1String256返回结果消息描 述 12 HEAD SvcCo nt 1String 应答报文体内容具体业务数据，以 XML 表达 SvcCo
12、nt 内容有可能为空，在进行应用拨测的时候 ADC 平台会发送 SvcCont 节点为空的报文。SI 系统返回 报文格式必须正确，报文内容在这种情况下可以返回错误。 2.1.3Message Body Message Body 为交易请求以及应答的内容，以 XML 格式存储，在交易报 文传输时作为 Message Header 的一个元素“SvcCont”和 Header 一起传输。 2.2接口方式接口方式 ADC 与 SI 平台主要采用 WebService 方式，接口协议使用 SOAP 协议； 部分接口采用文件方式，采用 FTP 协议。 。 3 3ADCADC 管理平台与管理平台与 SIS
13、I 应用系统的接口应用系统的接口 1.1 三网合一业务产品订购三网合一业务产品订购 1.1.1 业务功能业务功能 三网合一业务发生变化时，ADC 向 SI 同步订购关系 1.1.2 交易单元交易单元 发起方：ADC 落地方：SI 接口类型：实时接口 接口代码：swhy001 1.1.3 交易报文交易报文 请求 SvcCont： 父元素名称元素名称约束类型宽度描述取值说明 SvccontSwhyECOrder1- 集团订购 SwhyECOrderECCode1StringV64 集团编号 SwhyECOrderECName1StringV25 6 集团名称 SwhyECOrderECPayMen
14、tMsi s 1StringV20付费号码 SwhyECOrderHomeCity1StringV10 归属地市 编码 SwhyECOrder HomeCounty 1StringV10归属区县 编码 SwhyECOrderSpCode1StringV32 Sp 编码 SwhyECOrderSpName1StringV25 6 Sp 名称 SwhyECOrderOrderType1StringF2 业务类型01=短信业务 02=彩信业务 SwhyECOrderSMSECAccessP ort 1StringV32短信端口 号 基本接入号+4 位二级 ec 编码 SwhyECOrderMMSEC
15、Access Port 1StringV32彩信端口 号 基本接入号+4 位二级 ec 编码 SwhyECOrderDealID1StringV32 套餐 id SwhyECOrderDealName1StringV64 套餐名称 SwhyECOrderBeginTime1StirngF8 订购生效 日期 YYYYMMDD SwhyECOrderEndTime1StringF8 订购失效 日期 YYYYMMDD SwhyECOrderOprCode1StringF2 操作编码01=开通 02=退订 03=暂停 04=恢复 05=参数变更 06=套餐变更 SwhyECOrderOldDealID ？StringV32原有套餐 id 套餐变更时有 值 SwhyECOrderSmsLable1StringV32 企业签名 SwhyECOrderISSmsLimit 1StringF1是否受控 1=受控 0=不 受控 SwhyECOrder InvalidTimeSp anList * 此节点数为 0 时代表不限制 InvalidTimeSpa nList StartTime1StringF6 不允许下发 开始时间 HHMISS，采 用 24 小时制 InvalidTimeSpa nList EndTime1StringF6 不
