Question

我遇到了一些swagger的问题：我在.yaml文件中有这样描述的对象数组（地址）：

Address:
  properties:
    street:
      type: string
    city:
      type: string
    state:
      type: string
    country:
      type: string

这是另一个带有API定义的yaml文件（地址是一个参数）：

 - name: addresses
   in: formData
   description: List of adresses of the user. The first one is the default one.
   type: array
   items:
     $ref: '#/definitions/Address'

这是我在招摇的UI中添加的文字：

[
  {
    "street": "Bond street",
    "city": "Torino",
    "state": "Italy",
    "country": "Italy"
  }
]

但在node.js中，如果我打印收到的内容：

{＆＃34;地址＆＃34;：[＆＃34; [＆＃34;＆＃34; {＆＃34;＆＃34; \＆＃34; street \＆＃34;：\＆＃34; Bond street \＆＃34;，＆＃34;，＆＃34; \＆＃34; city \＆＃34;：\＆＃34;都灵\＆＃34;，＆＃34;，＆＃34; \＃34;州\＆＃34;：\＆＃34;意大利\＆＃34;，＆＃34;，＆＃34; \＆＃34;国家\＆＃34 ;: \＆＃34;意大利\＆＃34;＆＃34;＆＃34; }＆＃34;＆＃34;]＆＃34;]}

我得到一个解析错误......有一些额外的[和＆＃34;。似乎swagger将其解析为字符串（？）

Answer 1

要发送JSON数据，您需要使用in: body参数（不是in: formData）并指定操作使用application/json。 formData参数用于使用application/x-www-form-urlencoded或multipart/form-data的操作。

paths:
  /something:
     post:
       consumes:
         - application/json
       parameters:
         - in: body
           name: addresses
           required: true
           schema:
             type: array
             items:
               $ref: "#/definitions/Address"  # if "Address" is in the same file
               # or
               # $ref: "anotherfile.yaml#/definitions/Address"  # if "Address" is in another file

Swagger对象数组

1 个答案: