中国联通apaas能力开放平台api规范积分商城分册v19.docx

中国联通A-ＰａaＳ能力开放平台ＡPＩ规范－积分商城分册v1.9 ———————————————————————————————— 作者： ————————————————————————————————　日期： QB/CU XXX — QB/CU XXX —2016 中国联通公司企业标准 　 　 　 　 　 　 　　 　 　　　 中国联通公司 中国联通公司发布 中国联通A-PaaS能力开放平台 中国联通A-PaaS能力开放平台 API规范 积分商城分册 2017 2017-2实施 2017-2发布  概述 背景 随着行业和公司发展，IT和各业务领域更深度融合,IT已不仅是信息化部门的专有任务，越来越多业务单元需要直接参与到ＩT建设中。传统IＴ模式正在转变，“平台+应用”新格局快速形成,IT部门将逐步更加聚焦于IT整体规划、共享能力提供、数据聚合、基础设施和服务提供等领域。 为构建平台和应用间桥梁，A-PaaS能力体系应运而生，在2015年IT整体规划中,参照IＴ三层架构总体规划，进一步将各类公共业务能力进行沉淀，形成应用能力层（A-PaaS）,通过A-PaaS实现IT、数据、运营、应用能力的复用和整合，促进集中统一运营红利释放。 各类业务单元(BU)作为A－ＰaaS能力使用方，获得更加透明、标准化的平台能力支撑，通过平台+业务应用新的IT模式，最大程度发挥自身运营灵活性，并也可实现自身能力复用、沉淀。 各类能力单元(AＵ)做为A－PaaS能力提供方，视角也在逐步发生变化,由系统建设组织者逐步变为公共能力的生产者或运营者，可以专注能力潜力挖掘,打造更有价值的能力。 范围 此文档是A-PaaＳ能力开放平台对外提供的服务接口规范,适用于所有通过API和SＤK方式调用开放能力的场景。所有业务应用需要按照此规范要求进行服务调用,并根据返回结果做适当的业务处理。 平台介绍 A-PａaS运营支撑平台是面向业务单元的一个能力视图，是具体的服务、管理、交易平台，包括能力商店、能力开放平台、应用部署环境管理。通过能力商店实现能力提供统一管理,所有开放能力均在能力商店上架，统一管理，统一订购；通过能力开放平台，实现能力开放，对第三方、子公司、省分ＢU、总部BU提供统一能力调用；通过应用部署环境管理,为创新应用提供自助式分布式部署环境。 对于ＢU来说，A-PａaS运营支撑平台呈现业务标准化能力,屏蔽各能力提供平台差异化服务;另一方面对于内部各类AU提供规范服务接入,A-PａaS运营支撑平台是公司平台化运营的基础业务能力体系。 本规范主要是针对A-ＰaaS能力开放平台对外提供的服务接口规范; 参考文献 缩略语与术语 缩略语 英文缩写 英文全称 中文解释 A－PａａＳ Aｂiliｔy-Platforｍ ａs a Ｓｅrviｃe 业务能力层 Ｉ-PａaS Integrａtiｏｎ Ｐｌatfｏrm as ａ Seｒvice 技术组件层 AU Abiｌity Unit 能力单元 BU Ｂusｉnｅsｓ Uｎｉｔ 业务单元 APＰ－ＫEY ＡPP-KEY 应用ＩD ＡPＰ_SECRET APP＿SECRＥT 应用密钥 术语 本文档所涉及的术语定义请参见下表。 名词 解释 能力 用于支撑各类业务活动的公共要素或环节，各类业务应用的“公约数”、承载一定业务功能，可复用,相对稳定。一个能力可以包括多个服务 服务 服务是指提供某项业务功能的具体API接口 应用接入 业务单元使用能力开放平台的能力，完成业务应用建设的过程 业务经理 业务应用的建设与维护人员, 能力经理 能力的建设和运营人员，ＡU的能力提供方 平台运营方 A-PaaS整体运营基本责任单元,负责A-PaaS体系的运营 ＡPＩ调用方式 通过接口地址调用服务的技术实现方式 SDK调用方式 通过SDK方式调用服务的技术实现方式 接入技术 传输协议 采用ＨTTP传输协议,并采用RESTＦUL风格的服务访问方式。 POＳT把提交的数据则放置在HTTP包的包体中。 所有参数值需要转换为UTF－８编码。 支持POST请求方式的ＡPI接口，所需要拼接的ＵＲＬ格式示例如下： ａｐi/xxx（服务名称)／xx(版本号)? ＡPI调用方式 　 本章节主要介绍通过接口地址调用服务的技术实现方式,简称ＡPI调用方式; 传输协议 采用HTTP传输协议，并采用REＳTFUL风格的服务访问方式。 ＰOSＴ把提交的数据则放置在HＴTＰ包的包体中。 所有参数值需要转换为UTF-8编码。 支持PＯST请求方式的API接口,所需要拼接的UＲL格式示例如下: （服务名称）／ｘx（版本号)？ 　调用方式 通过HTTP POＳT请求方式进行API调用，并根据ＡPI规范拼接正确的URＬ,就能