服务总线接口规范

《服务总线接口规范》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、安徽电信服务总线接口规范安徽电信有限公司2014年02月服务总线接口规范版本记录版本号时间记录人变更原因变更描述V0.12014-1-5李超初始V0.22014-2-22李超修订增加接口参数描述第1章概述51.1概述51.2目标51.3规范使用对象及说明51.4名词解释6第2章服务设计原则62.1接口协议统一原则62.2数据格式统一原则7安徽电信服务总线第23页，共24页服务总线接口规范2.3服务定义唯一性原则72.4服务无状态原则72.5服务部署原则82.6服务组合原则82.7报文内容处理的原则82.8出入参设计原则92.9规则校验的原则92.

2、10数据量原则92.11同步调用原则102.12统一入口原则102.13持久化原则10第3章服务接入规范103.1调用方式113.2参数说明12安徽电信服务总线第23页，共24页服务总线接口规范3.2.1系统级参数123.3返回业务功能14第4章安全控制144.1访问鉴权154.2传输加密16第5章异常分类编码16第6章服务注册、注销、变更、调用流程176.1服务注册的流程176.2服务注册的内容186.3测试环境服务注册的流程19第7章服务治理197.1目标197.2检查方法207.3服务监控的指标21安徽电信服务总线第23页，共24页服务总线

3、接口规范7.4服务目录树22安徽电信服务总线第23页，共24页服务总线接口规范概述1.1概述本规范明确了安徽电信服务总线接入及服务使用的标准和规范，为服务使用方和服务提供方提供开发参考。1.2目标本规范为了指导各业务系统与服务总线平台的对接，实现以下目标：1)当服务总线接入业务系统服务时，为该服务提供方提供开发依据。2)当服务使用方调用服务总线提供的服务时，为该服务使用方提供开发依据。3)为服务使用过程中安全及控制提供标准和参考。1.3规范使用对象及说明本规范适用于所有新建或改造的服务接口，均需要遵守本规范约定。安徽电信服务总线第23页，共24页

4、服务总线接口规范1.1名词解释1)服务提供方：提供原始服务，并将服务发布到服务总线的内部业务系统、第三方企业或个人。2)服务使用方：使用服务总线上的服务进行应用开发的内部应用系统、第三方企业或个人。3)服务商：平台为统一管理服务的提供方和使用方，综合其统称为服务商。4)服务：服务是执行可重复任务的可发现资源，由外部化的服务规范进行描述。服务可分为技术服务和业务服务两种。第2章服务设计原则由于各个系统和平台之间存在差异性，为确保安徽电信服务总线的稳定高效，服务设计原则如下：2.1接口协议统一原则安徽电信服务总线第23页，共24页服务总线接口规范所有

5、服务的接口均基于Http协议。服务提供方和服务使用方必须同时使用同一种类型的技术来进行开发和调用，调用的服务通过HTTPURL中特定属性进行标识，具体见接口协议。1.1数据格式统一原则服务的接口数据包含业务所有的业务数据，数据采用JSON格式表示，并且符合相应的JSONSchema。服务提供方和服务消费方必须同时使用同一种格式进行数据交互。1.2服务定义唯一性原则一个服务应该只实现一个业务功能，业务功能的区别通过服务编码来区分，不应通过定义不同的业务数据在同一个服务编码下实现不同的业务功能。1.3服务无状态原则服务应是无状态的，两次请求之间无须状

6、态和会话的保持，并可以采用轮询的方式在负载均衡器上进行注册安徽电信服务总线第23页，共24页服务总线接口规范1.1服务部署原则服务应是全局的，不应区分本地网、大区等，但可以部署多份用以提供不同优先级的服务。1.2服务组合原则服务按照服务粒度设计成原子服务和组合服务。原子服务为最细粒度的服务，组合服务由原子服务组合而成。为有效提高组合服务的效率，跨系统的组合服务由服务总线调用不同的原子服务实现组合，系统内的组合服务由服务提供方在应用内部进行组合。1.3报文内容处理的原则服务请求和返回的的报文应符合JSONSchema格式。服务请求方和提供方应采用通

7、用的JSON解析器来构造和解析数据，JSON不同含义的段落应定义明确含义的字段名称，相同内容的数据应采用数组来进行描述，双方可根据JSON名称和路径进行精确安徽电信服务总线第23页，共24页服务总线接口规范定位，不应根据字段的顺序来获取字段值，字段值不受字段顺序调整的影响。报文统一采用UTF-8进行编码。1.1出入参设计原则为提高查询类服务的通用性和性能，查询类服务在入参中定义返回字段列表，服务提供方根据入参中指定的字段返回信息。查询内接口应在入参中定义分页参数，返回参数中应包含当前页数、总页数或是已到最后一页等信息。返回参数中如返回静态编码值时

8、应同时返回此编码值对应的名称。1.2规则校验的原则服务提供方应对请求报文格式和关键信息进行合规性和业务校验，防止非法访问和入侵。1.3数