examples 属性来记录多个响应示例。
此属性可添加到任意响应中,并具有以下架构。
为 API 端点记录多种响应变体。
examples 属性来记录多个响应示例。
此属性可添加到任意响应中,并具有以下架构。
responses:
"200":
description: 成功响应
content:
application/json:
schema:
$ref: "#/components/schemas/YourResponseSchema"
examples:
us:
summary: 美国的响应
value:
countryCode: "US"
currencyCode: "USD"
taxRate: 0.0825
gb:
summary: 英国的响应
value:
countryCode: "GB"
currencyCode: "GBP"
taxRate: 0.20
此页面对您有帮助吗?