来自json文件的BOST正文引用示例

Question

我试图为我的Swagger文章添加一个示例主体，并希望将示例模式引用到一个JSON文件中，但它不起作用。

我是否必须使用另一个ref类型或其他东西，或者我真的必须定义一个定义模型（为了可读性，我想避免这样做）？

{
 "name": "Standard",
 "validFrom": "2021-01-01T00:00:00.000Z",
 "validTo": "2021-12-31T00:00:00.000Z",
 "useHolidays": true,
 "workingDays": [
  {
    "dayIndex": 0,
    "dayStart": "8:00",
    "dayEnd": "20:00"
  }
 ],
 "uploadedBy": "um3i7um"
}

 * /business-calendar/:
 *    post:
 *      description: Add a new business calender
 *      responses:
 *        '200':
 *          description: Business calendar added
 *      requestBody:
 *        required: true
 *        content:
 *          application/json:
 *            schema:
 *              type: object
 *    parameters:
 *      - in: body
 *        name: body
 *        schema:
 *          $ref": '../../mock/data/calendar.json'
 *        required: true
 *        description: Calendar object
 *
 */

Answer 1

从他们在https://swagger.io/docs/specification/adding-examples/的文档中可以看出，似乎需要一个对象的集合模式，并且在一个示例通过它之后。我的猜测是，外部值可以是任何外部值，无论是链接还是文件。

 content:
  application/json:
    schema:
      $ref: '#/components/schemas/MyObject'
    examples:
      jsonObject:
        summary: A sample object
        externalValue: 'http://example.com/examples/object-example.json'