随着互联网的发展,越来越多的企业开始将自己的业务能力开放出来,以便更好地与其他企业进行合作。而API(Application Programming Interface,应用程序接口)则成为了实现业务能力开放的重要手段之一。API可以让不同的系统之间进行数据交换和通信,从而实现业务的互通和共享。
而REST(Representational State Transfer,表述性状态转移)则是一种基于HTTP协议的软件架构风格,它可以用于设计和实现Web服务。REST的核心思想是将资源(Resource)作为Web服务的核心概念,通过HTTP协议中的GET、POST、PUT、DELETE等方法对资源进行操作,从而实现Web服务的功能。
本标准规定了基于REST技术的业务能力开放API地址本的设计和实现要求。其中,地址本是指一组资源的集合,这些资源可以是企业的业务能力、数据、服务等。地址本的设计应该遵循REST的核心思想,即将资源作为Web服务的核心概念,通过HTTP协议中的GET、POST、PUT、DELETE等方法对资源进行操作。
本标准规定了地址本的资源结构、资源状态、资源操作、资源关系、资源表示、资源链接等方面的内容。其中,资源结构指地址本中资源的组织结构,应该符合REST的资源组织原则;资源状态指地址本中资源的状态,应该符合REST的状态转移原则;资源操作指地址本中资源的操作,应该符合REST的方法原则;资源关系指地址本中资源之间的关系,应该符合REST的链接原则;资源表示指地址本中资源的表示方式,应该符合REST的表述原则;资源链接指地址本中资源之间的链接方式,应该符合REST的链接原则。
本标准还规定了地址本的版本管理、安全性、性能、错误处理等方面的要求。其中,版本管理指地址本的版本控制方式,应该符合REST的版本控制原则;安全性指地址本的安全保障措施,应该符合REST的安全性原则;性能指地址本的性能要求,应该符合REST的性能原则;错误处理指地址本的错误处理方式,应该符合REST的错误处理原则。
相关标准
- GB/T 35273-2017 信息技术 服务组件体系结构(SCA)
- GB/T 35275-2017 信息技术 服务组件架构(SCA) 服务组件定义
- GB/T 35276-2017 信息技术 服务组件架构(SCA) 服务组件实现
- GB/T 35277-2017 信息技术 服务组件架构(SCA) 服务组件组装
- GB/T 35278-2017 信息技术 服务组件架构(SCA) 服务组件部署