编辑响应

响应用于定义响应主体和头中返回的 HTTP 状态码和数据。 您可以编辑先前为 API 定义中的路径操作创建的响应。

1. 提供以下信息：
   • 响应名称: 响应的名称。

     如果要编辑操作响应，那么此名称为 HTTP 状态码。

     如果要编辑响应组件，那么此名称定义一个键，该键支持在 API 定义中的其他位置引用此响应；该引用具有以下格式：

     #/components/responses/Name

     要更改名称，请单击 更新，然后在完成时单击 保存 。

   • 描述: 响应的描述。 您可以将 CommonMark 语法 用于富文本格式表示。
   • 头：头定义可在响应中返回的信息。

     要为响应定义新头，请单击 添加，然后参阅 创建头。

     要编辑现有头，请单击头名称，然后参阅 编辑头。

   • 内容：内容定义描述响应的内容。

     要为响应定义新的内容定义，请单击 添加，然后参阅 创建内容定义。

     要编辑现有内容定义，请单击内容定义名称，然后参阅 编辑内容定义。

   • 链接：链接描述了一个操作返回的各种值如何用作其他操作的输入。

     要为响应定义新链接，请单击 添加，然后参阅 创建链接。

     要编辑现有链接，请单击链接名称，然后参阅 编辑链接。

2. 完成后单击 保存 。