能力开放平台接口规范3.1版本@流量统付
统一接口能力平台接口调用流程与环境

统一接口能力平台接口调用流程与环境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年初中国移动通信集团公司业务支撑系统部组织开展本规范的编写工作。
在集团公司、各省公司领导和专家的意见基础上,开始了能力开放平台的规范编写。
可信计算密码支撑平台功能与接口规范.pdf

Functionality and Interface Specification of Cryptographic Support Platform for Trusted Computing
国家密码管......................................................................................................................................................... VI
引 言.......................................................................................................................................................... VII
1 范围 .............................................................................................................................................................. 1 2 规范性引用文件 .......................................................................................................................................... 1 3 术语与缩略语 .............................................................................................................................................. 1
中国移动集团业务两级账务清单规范——流量统付业务清单文件说明v1.0.1

中国移动集团业务两级账务清单规范——流量统付业务清单文件说明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版本@流量统付

能⼒开放平台接⼝规范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 概述此文档专为商盟支付平台的合作商户提供。
中国电信第三代移动通信统一配置接口规范V1.01

中国电信股份有限公司企业标准中国电信股份有限公司上海研究院目录前言 (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接口规范》:定义了业务运行过程中综合业务管理平台与业务引擎的接口规范。
统一支付业务规范说明v3

银行卡产业尚不完善,为其他支付服务组织提供了发展 空间
•持卡消费风气尚未形成,持卡消费额占社会消费零 售总额比例偏低(总交易金额中占比为1.66% ) •银行卡产业链有待专业化分工,收单市场待发展 (缺乏专业化的第三方服务机构 ) •银行卡市场以借记卡为主,阻碍网上支付快速发展, 信用卡市场占有率仅10%左右 •网上支付消费习惯逐渐形成,需求日益旺盛
安全策略
SP自服务门户
业务管理
合作伙伴 管理
服务管理
对账管理 结算管理
数据管理 退费管理
用户管理 运营管理 投诉管理
系统管理
配置管理 日志管理
权限管理
系统监控 升级管理
注册
认证
用户账户自服务
绑定
支付纪 录查询
卡服务
账户 充值
支付应用系统自服务集成
支付账户系统自服务集成
支付
WEB界面
POS界面
IVR界面
世 界 触 手 可 及 Connecting the World ‹#›
中国电信统一支付
统一支付平台支撑的业务类型
支付业务分 类
缴费类支付
充值类支付
订单类支付
消费类支付
电信账单类
其他账单类
数字商品
缴纳电信账单(固 缴纳公共事业费
数字商品代收费
话、小灵通、宽带) (水电煤气、有线)
账单
银行帐户/充值卡为 统一支付账户和其 它电信账户充值; 统一支付账户为其 他电信账户充值
世 界 触 手 可 及 Connecting the World ‹#›
中国电信统一支付
统一支付平台总体框架
支付应用系统
移动支付应 用系统
固网支付应 用系统
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
能力开放平台接口规范能力开放平台接口规范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和应用密钥,通过调用令牌接口,直接获得无需用户授权的访问令牌。