下载文档原格式
统一接口能力平台接口调用流程与环境1.背景介绍统一接口能力平台是一个业务集成平台，它集成了一级客服系统、各省CRM系统及各省能力平台的业务能力，即接口API。
2.网络结构及平台所处的位置3.术语绑定：指客户通过自助渠道进行业务办理时，需要先进行第3方帐号与手机号进行关联，平台对关联关系数据进行维护。
绑定方式有：手机号+随机码、手机号+密码凭证：指用户访问系统的身份，不同的身份进行不同类别的接口调用。
凭证分3个级别：一般凭证、随机码凭证、服务密码凭证。
凭证级别权限划分：一般凭证、随机码凭证只能用于业务查询类接口的调用，服务密码凭证用于业务办理类接口调用4.接口分类主要包含2大类接口：认证类、业务类（查询类、办理类）。
由于不同后端系统，认证机制不一样，所以平台提供的认证类接口、业务类接口是分系统的。
即，认证类与业务类接口要配套使用。
如：要使用一级客服的系统的话费查询接口，则先用一级客服的认证接口进行认证，而不能用其它系统的认证接口。
目前主要有省端系统、一级客服系统、商城能力开放平台系统。
省端系统是指各省的CRM及各省能力平台。
一级客服系统、商城能力开放平台是集团公司所提供的面向各省业务的系统。
5.业务接口调用要求自助渠道：调用业务接口前，要求先进行帐号绑定、凭证申请。
帐号绑定只进行一次，凭证申请则需看有效期，如果在有效期，则后续的业务接口调用就不用凭证申请了，如果失效，但还想继续做业务接口调用的，需要再次发起凭证申请。
人工渠道：调用业务接口前，要求先进行凭证申请。
申请后，且在有效期，则后续的业务接口调用就不用凭证申请了，如果失效，但还想继续做业务接口调用的，需要再次发起凭证申请。
6.接口使用逻辑流程先看下面的流程图：1.绑定接口调用：这一步是针对自助渠道要求的，绑定接口只需调用一次，如果成功，平台会保存绑定数据，这样后续的业务接口调用，就不用再调用绑定接口了。
绑定接口有2种绑定方式：随机码方式、服务密码方式。
前言本标准以第三代架构整体规划为指导，明确定义了中国移动省级能力开放平台的功能架构和系统边界，用以指导现有能力开放平台系统建设。
本标准主要包括能力开放平台系统架构、系统功能和技术要求等。
本标准是第三代架构系列标准之一，该系列标准的名称如下:序号标准编号标准名称本标准由中移技﹝﹞号文件印发。
本标准由中国移动通信集团业务支撑系统部提出，集团公司技术部归口。
本标准起草单位：本标准主要起草人：1.概述本编制说明是依据《能力开放平台业务规范》（以下简称“业务规范”）、《能力开放平台技术规范》（以下简称“技术规范”）、《能力开放平台接入规范》（以下简称“接入规范”），结合中国移动各省公司的实际建设情况，就有关问题做出补充说明。
编制说明用途在于：1、便于相关人员更好地阅读、理解、执行规范，更好地遵循能力开放平台规范建设各省公司的业务运营支撑系统。
2、提升服务管控、能力管控、标准化能力运营和运营者集中化管理的支撑能力，推进省级业务支撑系统能力通过省能力开放平台向内/外部渠道开放。
3、提供重点、热点问题的可选技术方案，开阔思路，供各省系统建设参考。
本文以语言简明、重点突出为原则，针对能力开放平台建设时可能出现的关键问题，进行了针对性的阐述。
2.能力开放平台规范导读2.1.编写目标中国移动编制能力开放平台规范的目标体现在以下几个层面：1、全面实现省级系统能力开放，对接全网渠道。
开放标准化能力，对接一级能力开放平台，实现天猫、京东及苹果直营店等第三方合作伙伴的统一接入，在此基础上根据本省业务需求向本省第三方合作伙伴开放能力。
2、实现省级业务支撑系统能力通过能力开放平台向内、外部渠道开放。
3、实现开发者应用快速上线和运营者集中化管理。
4、实现规范化的能力管控和标准化的能力运营，统一管理省级内部系统能力接口。
2.2.起草过程2015年初中国移动通信集团公司业务支撑系统部组织开展本规范的编写工作。
在集团公司、各省公司领导和专家的意见基础上，开始了能力开放平台的规范编写。
中国移动集团业务两级账务清单规范——流量统付业务清单文件说明V1.0中国移动通信有限公司2014年4月目录版本历史 (3)1概述 (4)2文件接口 (4)2.1文件格式 (4)2.1.1文件命名规则 (4)2.1.2文件格式说明 (4)2.1.3文件存放目录 (5)2.1.4文件校验 (5)2.2国内gprs清单文件 (5)2.2.1清单文件格式 (5)2.2.1.1头记录 (5)2.2.1.2清单记录 (6)2.2.1.3尾记录 (6)2.2.2配合省汇总文件格式 (7)2.2.2.1汇总头记录 (7)2.2.2.2汇总话单记录 (7)2.2.2.3汇总尾记录 (8)2.2.3主办省汇总文件格式 (8)2.2.3.1汇总头记录 (8)2.2.3.2汇总话单记录 (9)2.2.3.3汇总尾记录 (9)2.2.4错单文件格式 (9)2.2.4.1错单记录 (9)2.2.4.2尾记录 (10)2.2.5拒收文件格式 (10)版本历史1概述本文档描述了中国移动跨省集团业务BBOSS与省BOSS两级账务清单接口中，关于流量统付业务的清单规范，各成员归属省应按照本规范上传清单。
2文件接口2.1文件格式2.1.1文件命名规则文件采用纯文本格式，文件名定义如下表：(1)文件名中“YYYYMMDD”表示数据日期；(2)“XXX”代表省代码(3)“NNNN”表示当日文件序号（范围：000-9998），每日文件不超过9999个；(4)文件名前加“E”表示错单文件，BBOSS接收并处理完一个清单文件后，生成该文件对应的错单文件，文件名为“E” + 业务清单文件名，没有错单生成只有尾记录的错单文件；(5)“Fxxx”代表文件级错误代码，见《中国移动集团业务两级账务清单规范——流量统付业务清单文件检错标准》－文件级检错标准；(6)清单文件传输及采集说明:•流量统付业务按每手机号每统付业务订购每天一条纪录生成；•BBOSS下发给主办省的流量清单汇总数据按照每个统付业务订购每个手机号每天一条记录。
能⼒开放平台接⼝规范3.1版本@流量统付V3.0(v3.0) 2015-10-10⽬录1.前⾔ (4)1.1.术语 (4)1.2.缩略语 (4)2.接⼝概况 (5)2.1.接⼝简介 (5)2.2.通信机制 (5)2.3.接⼝安全 (5)2.3.1.数字签名 (6)3.系统对接 (7)3.1.接⼊说明 (7)3.2.接⼊⽅式 (7)3.3.接⼊地址 (7)3.4.调⽤参数 (7)3.5.参数加密 (8)3.6.获取令牌 (9)3.6.1.授权码模式 (9)3.6.2.简化模式 (10)3.6.3.客户端信任模式 (11)3.7.⽣成数据签名 (11)3.8.能⼒参数返回 (12)4.对外开放能⼒API (13)4.1.集团类业务 (13)4.1.1.成员添加/变更/删除 (13)4.1.2.集团成员已订购流量查询 (15)4.1.3.成员处理情况查询 (16)4.1.4集团帐户实时余额查询—新增接⼝ (18)5.回调第三⽅接⼝(规范) (20)5.1.成员添加/变更/删除结果通知 (20)6.附录 (22)1.前⾔本⽂档主要⽤于定义第三⽅应⽤与能⼒开放平台之间通讯的接⼝规范，作为程序开发的依据。
本规范主要包括以下⼏⽅⾯内容：接⼝通信机制、接⼝描述和接⼝定义。
1.1.术语本规范涉及的术语描述如下：表1-1术语1.2.缩略语表1-2缩略语2.接⼝概况2.1.接⼝简介能⼒开放平台将运营商内部能⼒开放给互联⽹的第三⽅系统，包含合约套餐办理类、流量类、业务查询类能⼒等。
本协议规范描述的接⼝如图1-1中所⽰。
接⼊系统图1-1 协议接⼝位置2.2.通信机制能⼒开放平台开放接⼝采⽤REST风格，使⽤HTTP+JSON/HTTP+XML报⽂⽅式承载交易信息。
2.3.接⼝安全本开放平台的接⼝安全通过2级的安全进⾏保障，描述如下：1、对调⽤⽅的⾝份认证，每个接⼊开放平台的第三⽅系统都需要进⾏调⽤服务器地址的提前注册；2、为每个接⼊⽅分配⼀个⾮对称密钥，约定⼀种对应签名算法，接⼊⽅的请求中必须加上签名参数，⽤于请求⽅⾝份验证和请求的防篡改验证；2.3.1.数字签名同3.7章节。
统统付商户后端接入模式开发指南版本号：1.3.2商盟商务服务有限公司版权所有文档更新记录版本状态描述修订日期作者v1.0 A 文档初建2014-3-20 陈灵龙v1.1 A 交易字段更新2014-4-02 沈嘉平v1.2 M 修改2014-4-02 冯常军v1.3M字段修改2014-4-26沈嘉平v1.3.1 M 增加手机短信动态码接口，修改快捷支付接口2014-6-12 沈嘉平v1.3.2 M修改手机动态码，快捷支付接口，注销接口，新增手机动态码异步接口2014-6-15S 沈嘉平目录1引言 (4)1.1概述 (4)1.2名词缩写及定义 (4)2开发规范 (5)2.1通信方式 (5)2.2接口说明 (5)3商户接口 (6)3.1获取手机动态码接口 (7)3.1.1功能描述 (7)3.1.2提交参数定义 (7)3.1.3返回参数定义 (9)3.2快捷支付接口 (10)3.2.1功能描述 (10)3.2.2提交参数定义 (10)3.2.3返回参数定义 (12)3.3快捷注销接口 (12)3.3.1功能描述 (12)3.3.2提交参数定义 (13)3.3.3返回参数定义 (13)3.4支付订单查询接口 (14)3.4.1功能描述 (14)3.4.2提交参数定义 (14)3.4.3返回参数定义 (15)3.5支付通知接口 (16)3.5.1功能描述 (16)3.5.2提交参数定义 (16)3.5.3返回参数定义 (17)3.6退款接口 (17)3.6.1功能描述 (17)3.6.2提交参数定义 (18)3.6.3返回参数定义 (18)3.7退款订单查询接口 (19)3.7.1功能描述 (19)3.7.2提交参数定义 (19)3.7.3返回参数定义 (20)3.8退款通知接口 (21)3.8.1功能描述 (21)3.8.2提交参数定义 (21)3.8.3返回参数定义 (22)3.9对账接口 (22)3.9.1功能描述 (22)3.9.2提交参数定义 (22)3.9.3对账文件定义 (23)4附录 (27)4.1银行参数表 (27)4.2签名机制 (28)4.2.1需要参与签名的参数 (28)4.2.2生成待签名字符串 (28)4.3RSA签名 (29)4.4业务返回码定义 (29)4.5扩展信息说明 (30)4.5.1终端详情说明 (30)1引言1.1 概述此文档专为商盟支付平台的合作商户提供。
中国电信股份有限公司企业标准中国电信股份有限公司上海研究院目录前言 (6)1适用范围 (7)2参考标准、文献 (8)3缩略语 (9)4SP数据统一配置 (10)4.1接口协议说明 (10)4.1.1数据类型定义 (10)4.1.2文件命名规范 (10)4.1.2.1数据配置文件命名规范 (10)4.1.2.2回执文件命名规范 (11)4.1.3其它说明 (12)4.2统一配置交互流程 (13)4.3统一配置接口文件体定义 (13)4.3.1数据配置文件DTD (13)4.3.2数据配置回执文件DTD (19)5用户数据配置 (20)5.1接口协议说明 (20)5.1.2数据类型定义 (20)5.1.3其他说明 (20)5.2API列表 (20)5.3复杂数据结构定义 (21)5.3.1 MMS业务 (21)5.3.1.1 CTSubscriberDetailInfo (21)5.3.1.4 CTListUserBWList (22)5.3.2 LCS业务 (22)5.3.2.1 TimeLir (22)5.3.2.2 AreaLir (23)5.3.2.3 LirDetail (23)5.3.2.4 SpLirDetail (23)5.3.2.5 UserLirDetail (23)5.3.2.6 CommResult (24)5.3.2.7 QryBaseResult (24)5.3.2.8 QrySpResult extends from CommResult (24)5.3.2.9 QryUserResult extends from CommResult (24)5.3.2.10 QryTargetListResult extends from CommResult (25)5.4消息体定义 (25)5.4.1 MMS业务 (25)5.4.1.1 SubscriberRegister (25)5.4.1.1.2 API协议类型 (25)5.4.1.1.3 API变量 (25)5.4.1.1.4返回值 (26)5.4.1.2 SubscriberInfoQuery (26)5.4.1.2.1 功能描述 (26)5.4.1.2.2 API协议类型 (26)5.4.1.2.3 API变量 (26)5.4.1.2.4 返回值 (26)5.4.1.3 SubscriberInfoModify (27)5.4.1.3.1 功能描述 (27)5.4.1.3.2 API协议类型 (27)5.4.1.3.3 API变量 (27)5.4.1.3.4 返回值 (27)5.4.1.4 SubscriberBWListQuery (28)5.4.1.4.1 功能描述 (28)5.4.1.4.2 API协议类型 (28)5.4.1.4.3 API变量 (28)5.4.1.4.4 返回值 (28)5.4.1.5 SubscriberBWListAdd (29)5.4.1.5.1 功能描述 (29)5.4.1.5.2 API协议类型 (29)5.4.1.5.3 API变量 (29)5.4.1.5.4 返回值 (29)5.4.1.6 SubscriberBWListDelete (29)5.4.1.6.1 功能描述 (29)5.4.1.6.2 API协议类型 (30)5.4.1.6.3 API变量 (30)5.4.1.6.4 返回值 (30)5.4.2 LCS业务 (30)5.4.2.1 SetBaseLir (31)5.4.2.1.1 功能描述 (31)5.4.2.1.2 API协议类型 (31)5.4.2.1.3 输入/输出参数 (31)5.4.2.1.4 返回结果 (32)5.4.2.2 GetBaseLir (33)5.4.2.2.1 功能描述 (33)5.4.2.2.2 API协议类型 (33)5.4.2.2.3 输入/输出参数 (33)5.4.2.2.4 返回结果 (34)5.4.2.3 AddLir (34)5.4.2.3.1 功能描述 (34)5.4.2.3.2 API协议类型 (34)5.4.2.3.3 输入/输出参数 (35)5.4.2.4 DelLir (35)5.4.2.4.1 功能描述 (35)5.4.2.4.2 API协议类型 (36)5.4.2.4.3 输入/输出参数 (36)5.4.2.4.4 返回结果 (36)5.4.2.5 QryLir (37)5.4.2.5.1 功能描述 (37)5.4.2.5.2 API协议类型 (37)5.4.2.5.3 输入/输出参数 (38)5.4.2.5.4 返回结果 (38)5.4.2.6 ModLir (39)5.4.2.6.1 功能描述 (39)5.4.2.6.2 API协议类型 (39)5.4.2.6.3 输入/输出参数 (39)5.4.2.6.4 返回结果 (40)5.4.2.7 AddSpLir (40)5.4.2.7.1 功能描述 (40)5.4.2.7.2 API协议类型 (41)5.4.2.7.3 输入/输出参数 (41)5.4.2.7.4 返回结果 (41)5.4.2.8 DelSpLir (42)5.4.2.8.1 功能描述 (42)5.4.2.8.2 API协议类型 (42)5.4.2.8.3 输入/输出参数 (42)5.4.2.8.4 返回结果 (43)5.4.2.9 QrySpLir (43)5.4.2.9.1 功能描述 (43)5.4.2.9.2 API协议类型 (44)5.4.2.9.3 输入/输出参数 (44)5.4.2.9.4 返回结果 (44)5.4.2.10 ModSpLir (45)5.4.2.10.1 功能描述 (45)5.4.2.10.2 API协议类型 (45)5.4.2.10.3 输入/输出参数 (45)5.4.2.10.4 返回结果 (46)5.4.2.11 QryTargetListBySpLir (46)5.4.2.11.1 功能描述 (46)5.4.2.11.2 API协议类型 (47)5.4.2.11.3 输入/输出参数 (47)5.4.2.11.4 返回结果 (47)5.4.2.12 QryTargetListByRequestorLir (48)5.4.2.12.1 功能描述 (48)5.4.2.12.2 API协议类型 (48)5.4.2.12.4 返回结果 (49)5.5返回值定义 (49)5.5.1 MMS业务 (49)5.5.2 LCS业务 (49)6用户注销接口 (50)6.1接口协议说明 (50)6.2接口描述 (50)6.2.1 方向 (50)6.2.2 接口协议 (50)6.2.3 接口形式 (50)6.2.3.1 文件目录 (50)6.2.3.2 文件命名 (50)6.2.3.3 同步频率 (51)6.2.3.4 话单文件格式 (51)7门户链接接口 (52)7.1接口协议说明 (52)7.2业务场景 (52)7.3P ORTAL重定向到业务引擎 (52)7.3.1功能描述 (52)7.3.2结构 (53)8内容同步 (54)8.1接口协议说明 (54)8.1.2文件命名规范 (54)8.1.2.1数据配置文件命名规范 (54)8.1.2.2回执文件命名规范 (55)8.1.3其它说明 (56)8.2内容同步交互流程 (57)8.3统一配置接口文件体定义 (57)8.3.1数据配置文件DTD (57)8.3.2内容同步回执文件DTD (58)9内容管理系统CP鉴权接口 (60)9.1概述 (60)9.2规范目的 (60)9.3列表 (60)9.4业务场景 (60)9.4.1 内容管理系统重定向到ISMP进行CP鉴权 (60)9.4.2 内容管理系统到ISMP查询CP信息 (61)9.5描述 (62)9.5.1 内容管理系统重定向到ISMP进行CP鉴权 (62)9.5.1.1 内容管理系统重定向到ISMP进行CP鉴权 (62)9.5.1.2 ISMP重定向回内容管理系统返回鉴权结果 (62)9.5.2 内容管理系统向ISMP查询CP信息 (63)9.5.2.1 查询CP信息请求 (63)9.5.2.2 查询CP信息应答 (63)前言3G综合业务管理平台与业务引擎的接口协议包括二个分册：第一分册《中国电信第三代移动通信ISMAP接口规范》：定义了业务运行过程中综合业务管理平台与业务引擎的接口规范。
联通WO+开放平台提供者指南（1）—API策略介绍目录：1、流量控制策略1.1、速率控制2、安全控制策略2.1、IP接入控制2.2、Token认证2.3、开发者身份认证3、数据映射3.1、XMLtoXML3.2、XMLtoSOAP3.3、SOAPtoXML3.4、SOAPtoSOAP4、脚本增强4.1、MVEL4.2、XSLT1、流量控制策略1.1、速率控制使用场景此策略控制API的全局并发调用速率。
指调用部署在商用环境的API所有请求速率之和不能超过此处配置的值。
并发请求数超限时，超过的请求将被拒绝并返回错误响应。
此策略可用于保护后端API服务器免受大数据量冲击，能力提供者可以根据后端API服务器性能调整来修改策略中的配置值。
配置说明在流程编排图中单击此策略图标，并参考表1配置速率控制策略。
表1 参数说明参数说明TPS 您可以配置10至500的TPS值。
说明：此策略默认值为100TPS。
即如果您不配置此策略，WO+能力共享平台按100TPS 控制商用环境API请求速率。
2、安全控制策略2.1、IP接入控制使用场景此策略通过配置IP地址白名单或IP地址黑名单的方式对所有的API调用请求进行鉴权，允许来自IP白名单中的访问请求接入系统，或拒绝来自IP黑名单中的访问。
您可以通过配置此策略提升安全性。
例如在发现网络攻击后，可以通过配置此策略拒绝来自攻击地址的API调用请求。
或者开发API时配置IP白名单，仅允许来自IP白名单的请求消息接入。
配置说明将IP接入控制策略图标拖拽至流程编排图中，并根据表1配置IP接入控制策略。
表1 IP策略配置示例场景填写说明仅允许单个IP如10.10.10.10的IP访问API。
“允许访问的IP地址”填写为允许访问的IP地址，子网掩码设为“255.255.255.255”。
仅拒绝某段地址如10.10.10.*的所有地址访问API。
“拒绝访问的IP地址”填写为拒绝访问的IP地址，子网掩码设为“255.255.255.0”。
中国移动通信企业标准网状网接口规范网状网能力开放平台分册 版本号：1.0.3 中国移动通信集团公司 发布╳╳╳╳-╳╳-╳╳发布 ╳╳╳╳-╳╳-╳╳实施QB-╳╳-╳╳╳-╳╳╳╳目录1范围 (1)2规范性引用文件 (1)3术语、定义和缩略语 (1)4与旧版本（一级BOSS枢纽接口规范）对应修改点说明 (2)5请求和应答报文说明 (3)5.1请求报文 (3)5.2应答报文 (3)6网状网能力开放平台接口 (3)6.1接口概述 (3)6.2网状网能力开放平台业务背景 (4)6.3账户余额查询接口 (6)6.3.1业务功能 (6)6.3.2业务流程 (7)6.3.3业务属性 (8)6.3.4交易单元 (8)6.4话费余额鉴权接口 (11)6.4.1业务功能 (11)6.4.2业务流程 (12)6.4.3业务属性 (13)6.4.4交易单元 (13)6.5套餐资源查询 (16)6.5.1业务功能 (16)6.5.2业务流程 (17)6.5.3业务属性 (18)6.5.4交易单元 (19)6.6流量共享开通状态查询 (22)6.6.1业务功能 (22)6.6.2业务流程 (23)6.6.3业务属性 (25)6.6.4交易单元 (25)6.7流量共享业务办理 (28)6.7.1业务功能 (28)6.7.2业务流程 (29)6.7.3业务属性 (31)6.7.4交易单元 (31)6.8流量共享资源查询 (34)6.8.1业务功能 (34)6.8.2业务流程 (36)6.8.3业务属性 (38)6.8.4交易单元 (38)7附录 (42)7.1机构系统编码 (42)7.2资源分类编码 (42)7.3用户状态编码 (42)8编制历史 (43)前言本标准描述网状网能力开放平台与省BOSS间通过网状网相连的接口，包括其功能、流程和相关交易的接口报文定义，业务提供范围和有关受理规定请参见参考文档。
本标准需与《中国移动网状网接口规范-总册》配套使用。
中国移动通信企业标准物联网运营管理平台和物联网业务网关接口规范接口规范T e c h n i c a l S p e c i f i c a t i o n f o r I n t e r f a c e b e t w e e n I o T S e r v i c e O p e r a t i o n P l a t f o r m a n d S e r v i c e G W版本号：1.0.0 中国移动通信集团公司 发布2011-12-30发布 2011-12-30实施 QB-D-177-2011目录前言 (V)1 围 (1)2 规性引用文件 (1)3 术语、定义和缩略语 (2)3.1. 术语、定义 (2)3.2. 缩略语 (3)4 基础通信接口 (4)4.1. 短信接口 (4)4.1.1.接口定义44.1.2.接口功能44.1.3.业务流程44.1.4.报文格式54.2. 彩信接口 (6)4.2.1.接口定义64.2.2.接口功能64.2.3.业务流程64.2.4.报文格式75 终端管理接口 (7)5.1. WMMP-A接口 (8)5.1.1.接口定义85.1.2.接口功能85.1.3.业务流程85.1.4.报文格式95.2. 终端注册请求鉴权接口 (10)5.2.1.接口定义105.2.2.接口功能105.2.3.业务流程105.2.4.报文格式115.3. 终端登录请求鉴权接口 (14)5.3.1.接口定义145.3.2.接口功能145.3.3.业务流程145.3.4.报文格式155.4. 终端退出登录通知接口 (17)5.4.1.接口定义175.4.2.接口功能175.4.3.业务流程185.4.4.报文格式185.5. 终端状态变更通知接口 (19)5.5.1.接口定义195.5.2.接口功能195.5.3.业务流程205.5.4.报文格式206 管理信息同步接口 (22)6.1. 平台信息同步接口 (22)6.1.1.接口定义226.1.2.接口功能226.1.3.业务流程236.1.4.报文格式236.2. 能力信息同步接口 (27)6.2.1.接口定义276.2.2.接口功能286.2.3.业务流程286.2.4.报文格式286.3. 能力订购关系同步接口 (31)6.3.1.接口定义316.3.2.接口功能316.3.3.业务流程326.3.4.报文格式326.4. 终端在线状态通知接口 (34)6.4.1.接口定义346.4.2.接口功能346.4.3.业务流程356.4.4.报文格式356.5. 终端通信故障信息同步接口 (36)6.5.1.接口定义366.5.2.接口功能366.5.3.业务流程376.5.4.报文格式376.6. 业务平台通信状态通知接口 (39)6.6.1.接口定义396.6.2.接口功能396.6.3.业务流程406.6.4.报文格式406.7. 能力接口 (41)6.7.1.管理平台能力请求接口416.7.1.1.接口定义 (41)6.7.1.2.接口功能 (42)6.7.1.3.业务流程 (42)6.7.1.4.报文格式 (43)6.7.2.管理平台能力服务接口456.7.2.1.接口定义 (45)6.7.2.2.接口功能 (45)6.7.2.3.业务流程 (46)6.7.2.4.报文格式 (46)6.7.3.管理平台能力服务结束确认接口486.7.3.1.接口定义 (48)6.7.3.2.接口功能 (48)6.7.3.3.业务流程 (48)6.7.3.4.报文格式 (48)7. 文件接口 (50)7.1. 终端在线信息批量同步文件接口 (50)7.1.1.接口定义507.1.2.接口功能507.1.3.业务流程507.1.4.报文格式518. 编制历史 (51)附录A 有关HTTP通信方式、接口方式等的说明 (51)前言本标准规定了物联网运营管理平台与物联网业务网关之间的技术接口。
中国联通综合营帐系统接口规范中国联合通信有限公司2001年6月1.概述中国联通作为国内唯一一家对所有电信业务拥有经营权的电信运营商，拥有全国范围内相当规模的公用电信网，经营多种基础电信业务和增值电信业务，形成移动、长途、国际、数据（165）、IP电话、电子商务、寻呼、增值业务、市话等多种业务并存共同发展的格局。
为了充分发挥综合优势，实现灵活多变的营销策略，实现多种业务“一台清、一单清”，为客户提供统一的、综合的、规范化的高质量服务。
中国联通推出了综合营帐系统。
由于目前中国联通已建和在建的营业及帐务系统基本上是分专业独立建设，管理机制上采用分项管理，加之各业务已有的营帐系统建设厂家多、数据量大、系统结构复杂，因此综合营帐系统的建设将是一个复杂而艰巨的任务。
为了充分保证系统的规范性和开放性，特提出综合营帐系统接口规范。
本接口规范以《中国联通综合营帐系统总体方案》、《中国联通综合营帐系统业务规范》和《中国联通综合营帐系统技术规范》为依据，在充分采纳广大厂家和分公司建议的基础上，经过联通信息系统部综合营帐系统接口规范小组的反复讨论制定。
接口规范将作为《中国联通综合营帐系统技术规范》的附件推出，和《中国联通综合营帐系统总体方案》、《中国联通综合营帐系统业务规范》、《中国联通综合营帐系统技术规范》一起对综合营帐系统的建设起到约束和指导作用。
1.1. 接口定义原则本规范所规定的接口是综合营帐子系统与各专业计费子系统之间的接口，以实现系统间的工单调度。
考虑到综合营帐子系统应该是消除各业务处理差别的环节，同时要求现有各专业计费子系统修改其与帐务接口的数据格式的工作量非常巨大，因此综合营帐子系统与各专业计费子系统之间的接口标准应尽量适应现有专业计费子系统。
综合营帐系统与个专业系统接口应达到如下目标：✧接口简单明了，便于形成、操作和传输，并尽量满足现在和将来的需求；✧接口能灵活地支撑综合营帐系统和各专业系统的业务需求；✧综合营帐系统与各专业系统的接口应充分考虑安全性，适用性，不影响综合营帐系统和专业系统的安全性能和业务性能。
平台流量接口管理制度一、总则为了规范平台流量接口管理，保障数据安全，提高运营效率，制定本管理制度。
二、管理范围本制度适用于平台内所有流量接口的管理，包括但不限于数据接口、API接口等。
三、流量接口申请与审批1. 平台内部部门或团队如需使用流量接口，需向流量接口管理部门提交申请。
2. 申请需包括接口名称、接口功能、使用场景、申请原因等相关信息，并附带申请人员的身份信息和联系方式。
3. 流量接口管理部门对申请进行审查，并根据申请情况进行审批。
审批结果将及时通知申请方。
4. 若申请被驳回，申请方可以根据驳回原因进行修改后再次申请。
5. 接口使用方需按照审批通过的使用规范和方式进行接口使用，不得私自修改接口调用、传输数据等操作。
四、流量接口使用规范1. 接口使用方需严格按照接口文档规定的调用方式、参数、协议等进行接口调用，并确保接口调用的合法性和安全性。
2. 接口使用方不得将接口用于非授权的用途，不得超出接口使用权限范围进行接口调用。
3. 接口使用方需妥善保管接口密钥、令牌等关键信息，不得泄露给其他未授权的人员或机构。
4. 接口使用方需保证接口调用的合理性和合规性，不得利用接口进行非法活动，不得侵犯他人的合法权益。
5. 接口使用方需及时升级和更新接口版本，保证接口调用的稳定性和安全性。
五、流量接口监控与报警1. 平台流量接口管理部门需建立接口调用日志记录系统，对接口调用进行实时监控。
2. 对于异常接口调用或超出设定阈值的调用，需及时进行告警，排查问题原因，确保流量接口的稳定性和安全性。
3. 对于频繁出现异常调用或恶意攻击等情况，需立即采取应急处理措施并报告相关部门。
六、流量接口安全管理1. 平台流量接口管理部门需定期对流量接口进行安全风险评估和漏洞扫描，并及时修复发现的安全漏洞。
2. 对于安全隐患较大的接口，需采取安全措施对接口进行保护，如加密传输、访问控制等。
3. 对于更新版本的接口，需进行安全测试和审核，确保新版本接口的稳定性和安全性。
流量统付业务改造特殊说明产品资费产品资费有两类，一类是EC资源池，X元包Y流量，超过每单位流量Z元，。
另一类是个人资费包，每个成员可以不同，但固定只有几档。
每个EC订购级的参数为折扣率，资源池模式X和Z有不同的折扣率，个人资费包模式，每个成员的折扣率都是一样的。
另外定向流量产品还可以收取功能费，具体功能费数值由客户经理填写实际折扣后的价格。
定向流量产品，暂停期间需要收取停机保号费，作为单独的Rateplan，在暂停的时候选择。
定向流量资费定向流量业务的资费包括流量资费和功能费。
对于流量资费，需区分流量池模式和个人流量包模式。
对于功能费，按照集团客户提交要求开通的局数据配置条数收取。
➢定向流量池资费及最低折扣➢定向流量个人流量包套餐资费及最低折扣表15➢功能费手输，元为单位通用流量资费通用流量业务的资费区分流量池模式和个人流量包两种模式。
标准资费及对应的折扣底线如下：➢通用流量池资费及最低折扣表16➢通用流量个人流量包套餐资费及最低折扣表17CRM特殊产品属性999044008为2时，999044009必填，为其他值时，4009属性无意义。
4008为1/2/3/5时，产品资费为EC流量池资费，4008=4时，产品资费为个人流量包资费。
特殊产品操作当4008属性为4时，客户经理可以对已经完成的订购关系进行流量叠加包的操作，该操作与省公司的两级订单流不通过订单和开通接口，通过专用接口；该操作对CRM订购关系不做归档，但是需要将本次增加的叠加包总金额累加作为一次性费用同步给计费。
这个操作拟完全独立完成，不通过订单操作来完成。
特殊流程操作根据服务开通反馈的产品属性确定BPM流程走向。
每月底生成统付月校验文件，格式同一点支付。
特殊成员流程操作1、允许配合省进行成员删除，走普通成员变更流程，需要判断成员是这个配合省的，且成员是有效的成员。
2、成员状态变更引起的成员变更，不经过服务开通，直接完成，归档给主办省、配合省。
平台流量接口管理制度范本一、总则第一条为规范平台流量接口的管理，保障平台内经营者、用户和其他利益相关者的合法权益，维护网络市场秩序，根据《中华人民共和国网络安全法》、《互联网信息服务管理办法》等法律法规，制定本制度。
第二条本制度所称平台流量接口，是指平台提供给外部系统或应用访问平台内部数据、服务的能力，包括API接口、SDK接口、开放平台等。
第三条平台流量接口管理应遵循合法合规、公平公正、安全可控、用户隐私保护的原则。
第四条平台运营者应建立健全流量接口管理制度，明确流量接口的申请、审核、使用、监控、评估、终止等环节的管理措施，确保流量接口的安全、稳定、高效运行。
二、流量接口申请与审核第五条申请方应具备以下条件：（一）具有合法有效的营业执照或其他主体资格证明；（二）具有良好的信用记录，无重大违法违规行为；（三）具备保障流量接口安全、稳定运行的技术能力；（四）承诺遵守本制度及平台其他相关制度。
第六条平台运营者应在收到申请后5个工作日内完成审核，并向申请方发出审核结果通知。
审核通过的，双方签订《流量接口使用协议》，约定接口使用范围、权限、费用等事项。
第七条平台运营者应定期对已合作的接口使用方进行评估，评估内容包括但不限于：合规性、安全性、稳定性、用户满意度等。
评估不合格的，平台运营者有权终止合作。
三、流量接口使用与管理第八条接口使用方应按照约定事项使用流量接口，不得超出授权范围，不得利用流量接口从事违法活动。
第九条接口使用方应确保流量接口的安全、稳定运行，如发生故障、漏洞等，应及时通知平台运营者并采取措施予以解决。
第十条接口使用方应定期对使用情况进行自查，确保符合法律法规和平台要求。
平台运营者有权对接口使用情况进行检查，接口使用方应予以配合。
第十一条接口使用方不得滥用流量接口，导致平台系统拥堵、服务中断等情形。
如发生此类情况，接口使用方应立即采取措施予以纠正，并承担相应责任。
四、用户隐私保护与数据安全第十二条接口使用方应严格遵守用户隐私保护法律法规，保护用户个人信息安全，不得非法收集、使用、泄露用户个人信息。
能力开放平台接口规范能力开放平台接口规范2015-10-10目录1. 前言................................................................... 错误!未定义书签。
. 术语 ................................................................ 错误!未定义书签。
. 缩略语 .............................................................. 错误!未定义书签。
2. 接口概况............................................................... 错误!未定义书签。
. 接口简介 ............................................................ 错误!未定义书签。
. 通信机制 ............................................................ 错误!未定义书签。
. 接口安全 ............................................................ 错误!未定义书签。
数字签名........................................................ 错误!未定义书签。
3. 系统对接............................................................... 错误!未定义书签。
. 接入说明 ............................................................ 错误!未定义书签。
. 接入方式 ............................................................ 错误!未定义书签。
. 接入地址 ............................................................ 错误!未定义书签。
. 沙箱测试地址：业务接口地址:调用参数................................. 错误!未定义书签。
. 参数加密 ............................................................ 错误!未定义书签。
. 获取令牌 ............................................................ 错误!未定义书签。
授权码模式...................................................... 错误!未定义书签。
简化模式........................................................ 错误!未定义书签。
客户端信任模式.................................................. 错误!未定义书签。
. 生成数据签名 ........................................................ 错误!未定义书签。
. 能力参数返回 ........................................................ 错误!未定义书签。
4. 对外开放能力API ........................................................ 错误!未定义书签。
. 集团类业务 .......................................................... 错误!未定义书签。
成员添加/变更/删除.............................................. 错误!未定义书签。
集团成员已订购流量查询.......................................... 错误!未定义书签。
成员处理情况查询................................................ 错误!未定义书签。
集团帐户实时余额查询—新增接口............................................. 错误!未定义书签。
5. 回调第三方接口(规范) ................................................... 错误!未定义书签。
. 成员添加/变更/删除结果通知 .......................................... 错误!未定义书签。
6. 附录................................................................... 错误!未定义书签。
1.前言本文档主要用于定义第三方应用与能力开放平台之间通讯的接口规范，作为程序开发的依据。
本规范主要包括以下几方面内容：接口通信机制、接口描述和接口定义。
1.1.术语本规范涉及的术语描述如下：表1-1术语1.2.缩略语表1-2缩略语➢2.接口概况2.1.接口简介能力开放平台将运营商内部能力开放给互联网的第三方系统，包含合约套餐办理类、流量类、业务查询类能力等。
本协议规范描述的接口如图1-1中所示。
接入系统图1-1 协议接口位置2.2.通信机制能力开放平台开放接口采用REST风格，使用HTTP+JSON/HTTP+XML报文方式承载交易信息。
2.3.接口安全本开放平台的接口安全通过2级的安全进行保障，描述如下：1、对调用方的身份认证，每个接入开放平台的第三方系统都需要进行调用服务器地址的提前注册；2、为每个接入方分配一个非对称密钥，约定一种对应签名算法，接入方的请求中必须加上签名参数，用于请求方身份验证和请求的防篡改验证；2.3.1.数字签名同章节。
3.系统对接3.1.接入说明凡是接入河南移动能力平台的第三方系统，一律按照本规范接入能力开放平台。
第三方渠道在申请能力后首先需求调用沙箱接口进行测试，测试通过后再调用业务接口进行业务联调和使用。
3.2.接入方式协议：http3.3.接入地址3.4.沙箱测试地址：业务接口地址: 调用参数调用API ，需传入系统参数和业务参数。
系统参数拼接在URL上，业务参数放在POST体中。
对于接口说明中的标记为必填项的字段，必须有相应的非空、合法性校验，并精确返回异常信息，如：MobileNo不合法。
系统参数详细介绍如下；业务参数由于不同 API 各自不同。
1、系统参数默认采用json格式，参数列表如下序号参数命名参数名称长度类型是否必选备注协议参数1method能力编码64String Y如“SO_BUSI_CHANGE_IMEI”填json 或 xml,指定业务2format业务参数格式20String Y参数格式3appId应用编码12Inter Y5012204version版本20String N如5accessToken oauh授权令牌100String Y5ea6f06f-796b-48a2-a825-系统参数格式示例：method=SO_BUSI_CHANGE_IMEI&format=json&appId=501449&appKey=8ea63a3e403228eedf5dfd6a705c 685c&busiSerial=1&version=3546fbdb6b1041cb4eb26339b9154e2c&accessToken=5ea6f06f-796b-48 a2-a825-35a1909adffa×tamp=20&sign=EEd8sPcxlULRz7MThkVcUfIVEwfuT5Db+Tb8qfmRib2pK2hC HG8MqgsVebW1mmSv6Ml8jnqJmh1czWLgY1DuL8f4wJ3c68yTc8l5业务参数业务参数格式按照系统参数”format”所指定的格式来传递。
1）如json格式示例:{"BillId":"Qbnx8gxDELYpQODlqYFbM9nq7XnqQHIt0lu2mC4ozOJYKJKiD2fMTkrPKRsY4uXeUek/8IVfcE2y wCzTwZXlrzr/f2QXRA2jLNuM"}2）xml格式示例：<root><BillId>Qbnx8gxDELYpQODlqYFbM9nq7XnqQHIt0lu2mC4ozOJYKJKiD2fMTkrPKRsY4uXeUek/8IVfc E2ywCzTwZXlrzr/f2QXRA2jLNuM</BillId></root>注：如果系统参数需要放在POST体中，需要在URL中加入固定的参数及指定业务参数的key，URL示例如：3.5.参数加密对业务参数采用整体加密规则，使用AES256算法，调用sdk加密方法（sdk包见生成数字签名）进行加密，加密示例如下：注：dataSecret为数据加密密钥，默认为应用密钥。
3.6.获取令牌依据应用信息里的授权类型不同，分以下三种方式获取访问令牌：3.6.1.授权码模式适用于有服务端的应用（如web应用），分两步获取最终访问令牌：调用授权接口：请求参数：响应参数：调用范例：&redirect_uri=&response_type=code成功应答：&open_id=8911f179-bc87-4412-9712-24b4921f2c31调用令牌接口：请求参数：响应参数：调用范例：&app_key=f575e386e80d4cb634c2e9ae0b7b541a&grant_type=authorization_code&code=3Pv8kS&red irect_uri=成功应答：{"access_token":"a9ae4ae1-f062-4ff6-b0b8-fd73d96e558b","token_type":"bearer","refresh_t oken":"0b00920b-74c8-4ebb-8081-6c8191df4d4b","expires_in":299}3.6.2.简化模式适用于没有服务端的应用（如手机/桌面客户端程序），通过调用开放平台授权接口，一步获得最终的访问令牌，获取方式如下：调用授权接口：请求参数：响应参数：调用示例：&app_key=3ff70dd0b3e9d13264c57813&redirect_uri=&response_type=token成功应答：&token_type=bearer&open_id=8911f179-bc87-4412-9712-24b4921f2c31&expires_in=2993.6.3.客户端信任模式适用于无需用户登录授权的合作应用场合，应用凭自身的应用ID和应用密钥，通过调用令牌接口，直接获得无需用户授权的访问令牌。
