术语

API

API（Application Programming Interface，应用程序接口）是一些预先定义的函数，目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力，而又无需访问源码，或理解内部工作机制的细节。

API Gateway

API Gateway（Application Programming Interface gateway，API网关）是当前API的一个公共服务，是所有API注册和发布的入口。

JSON

JSON(JavaScript Object Notation) 是一个轻量级的数据交换格式，它易于人类读写及其解析生成。

HTTP

HTTP（Hyper Text Transfer Protocol）是超文本传输协议。

HTTPS

HTTPS（Hyper Text Transfer Protocol over Secure Socket Layer）是安全版超文本传输协议。

REST

REST（Representational State Transfer，表征状态转移）网络上的所有事物都可被抽象为资源，每一个资源都有唯一的资源标识（resource identifier），对资源的操作不会改变这些标识，所有的操作都是无状态的，使用标准方法操作资源。

RESTful风格的服务接口需定义：操作名、URL、请求和响应消息体和响应状态码。

本文后续章节将分别描述接口各部分的定义规范。