swagger - 不允许路径中的对象数组

Question

是否可以在get参数中包含一个复杂对象数组？ 如果我尝试这段代码，我会因为这一行而收到参数定义错误：$refs: '#/definitions/pax'

swagger: '2.0'
info:
version: 0.0.0
title: Simple API
paths:
 /:
    get:
      parameters:
        - name: passengers
          in: query
          type: array
          items:
             $refs: '#/definitions/pax'

    responses:
      200:
        description: TODO

definitions:
  pax:
    type: object
    properties:
      name:
        type: string
      familyname:
        type: string

Answer 1

对于请求参数，只有body参数可以用Object（模型）定义。

您需要提供 URL 查询字符串的示例，以便我们可以帮助您使用 Swagger/OpenAPI 规范定义它。