RAML 1.0 文件上传定义

Question

在官方页面 (http://raml.org/developers/raml-200-tutorial#body-parameters) 上的 RAML 教程中，文件上传的定义如下所示：

/file-content:
  post:
  description: bla
  body:
    multipart/form-data:
      formParameters:
        file:
          description: The file to be uploaded
          required: true
          type: file

然而，这似乎只适用于 RAML 0.8，而不适用于 1.0。 1.0 的 "What's New" 部分还包含此文本："Uniformly covers bodies, URI parameters, headers, and query parameters and eliminates the need for a separate formParameters construct"。 (https://github.com/raml-org/raml-spec/blob/master/versions/raml-10/raml-10.md/#whats-new-and-different-in-raml-10)

看来整个事情都变了，但我找不到这方面的示例，而且我不明白如何将 fileupload 示例迁移到工作 1.0 示例。有什么想法吗？

Answer 1

我自己想出来了：

body:
  multipart/form-data:
    description: The file to be uploaded.
    required: true
    type: file
    example: !include someFile

Answer 2

我就是这样做的。其中 "file" 属性将是 formDataParam 名称。
您可以通过在其下添加更多属性来指定多个文件。

body:
      multipart/form-data:
        properties:
          file:
            description: The file to be uploaded. Supported Formats are gif, jpeg, jpg, png.
            required: true
            type: file
            example: !include example.jpg

RAML 1.0 文件上传定义

RAML 1.0 File Upload Definition

raml