raml 1.0 响应类型

Question

我正在尝试构建 RAML 文档 (v 1.0)，但在最初阶段我就卡住了。我有供应商资源，我定义如下：

types:
    Vendor: 
        type: object
        properties:
            name: string
            url: string
            service_email: string
            service_phone: string
            image: string

/vendors:
  description: foo bar
  displayName: Vendor
  get:
    description: retrieve a list of vendors
    responses:
      200:
        body:
          application/json:
            type: ???
            uniqueItems: true

  /{ident}:
    get:
      description: retrieve a single vendor item identified by ident
      responses:
        200:
          body:
            application/json:
              type: Vendor

我只是想不出在 get 请求上为 type 写什么（??? 现在在哪里） api 以 vendor 类型的对象数组响应，但我该如何将其传达给RAML?

Answer 1

尝试：

type: Vendor[]

您可以阅读更多官方文档：http://docs.raml.org/specs/1.0/#raml-10-spec-array-types

raml 1.0 响应类型

raml 1.0 response types

api

documentation

rest

yaml

raml