Json 覆盖Swagger UI中的动词级模型/模型架构

Json 覆盖Swagger UI中的动词级模型/模型架构,json,api-design,swagger,swagger-ui,Json,Api Design,Swagger,Swagger Ui,我正在使用swagger ui,试图标准化API文档。我意识到,对于使用主体参数并因此需要显示模型和模型模式的动词(GET、PUT、POST等),模式是在资源级别定义的(/pet或/store在pet store示例中)。然而,在我们的API中,所需的主体参数将随着动词的变化而变化,最好能为每个动词建立一个模型,准确地反映这一点 中模型定义的当前版本,其中模型定义如下: 有没有办法在谓词级别覆盖默认的资源级别模型?在swagger 2.0规范中,每个资源都有HTTP方法的子部分(get、pos

我正在使用swagger ui,试图标准化API文档。我意识到,对于使用主体参数并因此需要显示模型和模型模式的动词(GET、PUT、POST等),模式是在资源级别定义的(/pet或/store在pet store示例中)。然而,在我们的API中,所需的主体参数将随着动词的变化而变化,最好能为每个动词建立一个模型,准确地反映这一点

中模型定义的当前版本,其中模型定义如下:


有没有办法在谓词级别覆盖默认的资源级别模型?

在swagger 2.0规范中,每个资源都有HTTP方法的子部分(get、post、delete等)。每一个都有一个parameters标记,它映射到下面形式的JSON对象列表。为了让主体使用单独的模式,可以使用模式标记和
$ref
子标记覆盖它,然后引用您在底部的定义小节中单独提供的定义

{
    name: "body",
    in: "body",
    description: "set the properties of a pet",
    schema: {
        $ref: "#/definitions/PetPut"
    },
    required: true
}