1、中国移动通信有限公司ADC 平台接口规范(福建)福 建 移 动 通 信 公 司文档变更记录序号 变更内容说明 版本号 版本日期 执笔人1 创建 1.0 2014-7-10 郑磊2 修订二级 ec 编码定义为 4 位 1.2 2004-10-20 郑磊目 录1 概述 .11.1 接口概述 .11.2 文档概述 .11.3 引用标准 .12 总体规范 .22.1 消息结构 .22.1.1 请求报文 .22.1.2 应答报文 .32.1.3 Message Body .52.2 接口方式 .53 ADC 管理平台与 SI 应用系统的接口 .61.1 三网合一业务产品订购 .61.1.1 业务功能 .
2、61.1.2 交易单元 .61.1.3 交易报文 .61.2 三网合一业务黑白名单同步 .81.2.1 业务功能 .81.2.2 交易单元 .81.2.3 交易报文 .84 附录 .94.1 归属地市编码 .94.2 行业类型编码 .115 SI 方接口实现补充注意事项 .155.1 SI 数据强制覆盖原则 .155.2 SI 接口调用超时控制 .155. 文件接口. 375.1 文件的发送和获取.375.2 文件检验.375.3 业务统计数据接口 .375.4 业务统计数据对帐接口.405.5 业务统计报表接口. 415.6 FTP 服务器配置. 431 概述1.1 接口概述ADC 管理平台
3、是本省 SI 应用的接入点，根据规划，ADC 需要与 SI 应用系统进行信息交换与同步，表 1 概要说明了 ADC 管理平台与 SI 应用系统间的接口操作的内容。表 1 ADC 管理平台与 SI 应用系统间接口一览表序号 业务名称 交易名称 业务发起方 备注1 SSO 鉴权 SSO 鉴权 SI 实时2 SSO 心跳接口 SSO 心跳接口 SI 实时3 服务开通和修改 服务开通和修改 ADC 实时4 服务状态变更 服务状态变更 ADC 实时5 客户成员管理 客户成员管理 ADC 业务分配使用6 SI 客户端鉴权和心跳 SI 客户端鉴权和心跳 SI 实时7 业务统计数据接口 业务统计数据接口 SI
4、 文件8 业务统计报表接口 业务统计报表接口 SI 文件9 业务统计数据对帐接口 业务统计数据对帐接口 ADC 文件10 SI 业务状态及性能检测 SI 业务状态及性能检测 ADC 实时11 体验用户 SSO 鉴权接口 体验用户 SSO 鉴权接口 SI 实时12 代理商 SSO 鉴权和心跳 代理商 SSO 鉴权和心跳 SI 实时13 代理商信息查询接口 代理信息查询接口 SI 实时1.2 文档概述本文的后续部分将分别描述这些接口的功能、流程、属性和接口报文格式。1.3 引用标准1中国移动通信集团公司 省 BOSS 与业务管理平台（业务平台）接口规范（暂行）（V1.1.0）2中国移动通信集团公司
5、 全网行业应用业务规范3中国移动通信集团公司 中国移动一级 BOSS 系统接口规范-全网行业应用-SMS 业务单行本-IAGW-M 部分 2.0.04 中国移动一级 BOSS 系统接口规范 V1.4.55 网站集团业务接口协议 （动力 100 与 BOSS 的接口规范）2 总体规范总体规范定义传输协议、报文结构，具体如下。2.1 消息结构每个交易消息(包括请求和应答)有一个是名字（Message Name），交易消息以 XML格式表达的，根据 XML 的定义，每个 XML 文件需要有特定的 Root Tag（根标记），在本规范中，用消息名作为根节点，根节点下包括两个部分：Message Hea
6、der(消息头)与Message Body (消息体，交易业务内容)。其中，Message Header 用于存储交易请求以及应答的公共部分和消息的控制数据，而 Message Body 作为消息体，包含交易请求和应答的业务数据。在本文档中以表格的形式表示 XML 格式，以下为表格中对元素约束（出现次数）的表示方法的描述：符号 含义? 0.1，可选项* 0.n，可以没有，也可以有多项+ 1.n，至少有 1 项，也可以有多项1 数字 1，代表必须且只能填 1 项另外，报文格式中“F”指固定长度，“V”表示变长。2.1.1 请求报文ADC 与 SI 系统接口请求报文各个字段解释如下表。SvcCon
7、t 是报文体的内容，以 XML 的格式表达，作为报文头的最后一个信息，与报文头一起传送，其他信息是报文头信息，作为标识、控制等信息。ADC 与 SI 应用系统接口请求报文各个字段解释如下表。序号父元素名称元素名称 约束 类型长度 描述 取值说明1 HEAD BizCode 1 String V16 消息标志 接口业务代码,5 位,见 ADC 管理平台SI 接口业务代码表:2 HEAD TransID 1 String V16 消息序列号在发起方唯一标识一个交易的流水号，系统内唯一16 位唯一流水 组成方式：”SI”8 位日期6 位唯一数，每天从 000001 开始，如SI20060801000
8、0013 HEAD ActionCode 1 Integer F1 动作码 1-请求，2- 应答4 HEAD TIMESTAMP 1 String F18 时间戳 系统时间戳,格式为:YYYYMMDDHHmmssnnnn5 HEAD SIAppID 1 String V16 业务应用标识 标识是哪个 SI 应用系统，每个 SI 系统约定（分配）一个标识6HEADTestFlag 1 Integer F1 测试标记发起方填写，0：非测试交易，1：测试交易；测试必须是业务级别，即在同一个业务流水中所有交易必须具有相同的测试标记7 HEAD Dealkind 1 Integer F1 同步异步方式
9、0 同步操作 ， 1 异步操作8 HEAD Version 1 String F4 业务内容报文的版本号 保留字段，对于同一交易应答与请求版本号始终一致9 HEAD Priority 1 Integer 优先级 保留字段，此处填 010 HEAD SvcCont 1 String 请求报文体内容 具体业务数据，以 XML 表达2.1.2 应答报文ADC 与 SI 应用系统接口应答报文各个字段解释如下表。序号父元素名称元素名称 约束 类型长度 描述 取值说明1 HEAD BizCode 1 String V16 消息标志 接口业务代码,5 位,见 ADC 管理平台SI 接口业务代码表:2 HEA
10、D TransID 1 String V30 消息序列号 同发起方的流水号3 HEAD TIMESTAMP 1 String F18 时间戳 系统时间戳,格式为YYYYMMDDHHmmssnnnn4 HEAD ActionCode 1 Integer F1 动作码 1-请求，2- 应答5 HEAD SIAppID 1 String V16 业务应用标识 标识是哪个 SI 应用系统，每个 SI 系统约定（分配）一个标识6 HEAD TestFlag 1 Integer F1 测试标记 同发起方的请求报文7 HEAD Dealkind 1 Integer F1 同步异步方式 0 同步操作 ， 1
11、异步操作8 HEAD SvcConVer 1 String F4 业务内容报文的版本号 保留字段，对于同一交易应答与请求版本号始终一致9 HEAD Priority 1 Integer 优先级 保留字段，此处填 010 HEAD ResultCcode 1 String 16 返回结果代码 0=成功 1=失败11 HEAD ResultMsg 1 String 256 返回结果消息描述12 HEAD SvcCont 1 String 应答报文体内容 具体业务数据，以 XML 表达SvcCont 内容有可能为空，在进行应用拨测的时候 ADC 平台会发送 SvcCont 节点为空的报文。SI 系统
12、返回报文格式必须正确，报文内容在这种情况下可以返回错误。2.1.3 Message Body Message Body 为交易请求以及应答的内容，以 XML 格式存储，在交易报文传输时作为 Message Header 的一个元素“SvcCont”和 Header 一起传输。2.2 接口方式ADC 与 SI 平台主要采用 WebService 方式，接口协议使用 SOAP 协议；部分接口采用文件方式，采用 FTP 协议。3 ADC 管理平台与 SI 应用系统的接口1.1 三网合一业务产品订购1.1.1 业务功能三网合一业务发生变化时，ADC 向 SI 同步订购关系1.1.2 交易单元发起方：A
13、DC落地方：SI接口类型：实时接口接口代码：swhy0011.1.3 交易报文请求 SvcCont：父元素名称 元素名称 约束 类型 宽度 描述 取值说明Svccont SwhyECOrder 1 - - 集团订购SwhyECOrder ECCode 1 String V64 集团编号SwhyECOrder ECName 1 String V256集团名称SwhyECOrder ECPayMentMsis1 String V20 付费号码SwhyECOrder HomeCity 1 String V10 归属地市编码SwhyECOrder HomeCounty 1 String V10 归属区
14、县编码SwhyECOrder SpCode 1 String V32 Sp 编码SwhyECOrder SpName 1 String V256Sp 名称SwhyECOrder OrderType 1 String F2 业务类型 01=短信业务02=彩信业务SwhyECOrder SMSECAccessPort1 String V32 短信端口号基本接入号+4位二级 ec 编码SwhyECOrder MMSECAccessPort1 String V32 彩信端口号基本接入号+4位二级 ec 编码SwhyECOrder DealID 1 String V32 套餐 idSwhyECOrder
15、 DealName 1 String V64 套餐名称SwhyECOrder BeginTime 1 Stirng F8 订购生效日期YYYYMMDDSwhyECOrder EndTime 1 String F8 订购失效日期YYYYMMDDSwhyECOrder OprCode 1 String F2 操作编码 01=开通02=退订03=暂停04=恢复05=参数变更06=套餐变更SwhyECOrder OldDealID ？ String V32 原有套餐id套餐变更时有值SwhyECOrder SmsLable 1 String V32 企业签名SwhyECOrder ISSmsLimit
16、 1 String F1 是否受控 1=受控 0=不受控SwhyECOrder InvalidTimeSpanList * 此节点数为 0时代表不限制InvalidTimeSpanList StartTime 1 String F6不允许下发开始时间HHMISS，采用 24 小时制InvalidTimeSpanList EndTime 1 String F6不允许下发结束时间HHMISS，采用 24 小时制。EndTimeStartTimeSwhyECOrder SendToOtherProvinces 1 String F1 外省下发权限5=关闭 7=开启，默认为关闭SwhyECOrder
17、PortLevel 1 String F1 端口等级1=银牌级2=金牌级3=VIP4=自定义SwhyECOrder SendMaxSpeed 1 int 最大发送速率 单位:条/秒SwhyECOrder MonthSendMax 1 int 月最大发送量 单位:条SwhyECOrder RBList 1 String F1 黑白名单类型 1=白名单2=黑名单SwhyECOrder Tradeclass_Top ？ String V32 行业大类SwhyECOrder Tradeclass ？ String V32 行业小类应答 SvcCont：无1.2 三网合一业务黑白名单同步1.2.1 业务
18、功能ADC 在三网合一类业务发生黑白名单变更时，进行同步。1.2.2 交易单元发起方：ADC落地方：SI接口类型：文件接口，FTP 传递文件格式：XML文件编码：UTF-8文件名：swhyBwList_xxxxx_yyyymmddhhmms_zzzz.xml其中：xxxxx 代表 sp 编码；yyyymmddhhmmss 代表文件生成时间；zzzz 标示流水ftp 服务器由 ADC 侧提供1.2.3 交易报文父元素名称 元素名称约束 类型长度 描述 取值说明SWHY UserInfo 1 用户信息UeInfo SpCode 1 String V50 Sp 编码UserInfo ServCode
19、Prop 1 String V50 业务代码 01=SMS02=MMSUserInfo ECCode 1 String V50 集团编号UserInfo ECAccessPort 1 String V10 端口号 基本接入号+4 位二级 EC 编码UserInfo UserData * - - 黑白名单信息UserData MobNum 1 String F11 号码UserData RBList 1 String F1 黑白名单类型 1=白名单2=黑名单UserData OprCode 1 String F2 操作代码01=加入名单02=退出名单03=暂停04=恢复UserData EfftT 1 String F8用户希望的生效时间YYYYMMDD，如 EfftT 与操作编号中的日期相同，表示立即生效；否则表示在指定日期（EfftT）生效。
