公共模型

数据模型

数据模型和编程语言里的数据结构概念类似，主要用于接口设计场景中的“返回响应”和json/xml类型的“Body参数”。

在设计API的Body体或响应体时，可以直接引用公共数据结构。

数据结构被引用后，可以在数据结构的文档页面查看引用当前数据结构的API和模型。

公共响应

接口的公共响应返回结果，响应类型默认为“application/json”结构。

在设计API的响应体时，可以直接引用已设计好的公共响应。

公共响应文档页面可以查看引用当前公共响应的API。

公共参数

接口的公共请求参数，参数位置可选“query”参数、“path”参数、“header”参数。

在设计API的请求参数时，可以引用已设计好的公共参数。

公共参数文档页面可以查看引用当前公共参数的API。

公共请求体

接口的公共请求体，默认请求类型为“application/json”。

支持设计Body体引用，并且在公共请求体的文档页面支持查看引用当前公共请求体的API。

公共示例

接口的公共示例，可在API设计请求体示例与返回响应的响应示例中被引用，在公共示例的文档页面可查看引用当前公共示例的API。

安全模型

安全模型类别提供“http”、“apikey”、“oauth2”、“openIdConnect”四种类型选择，选择不同类型的安全模型后，需要在方案内容中完善相关必填信息，用于API设计中“安全方案”的引用。在安全模型的文档页可以查看引用当前安全模型的API。

公共响应头

接口的公共响应头，在API设计中“返回响应”中响应头可进行公共响应头的引用。在公共响应头的文档页可以查看引用当前公共响应头的API。