Question

[在此处输入图片说明] [1] I know my syntax is wrong in the image here . But just want to let you know what I'm trying to achieve.I'm using RAML 0.8. I want to include multiple requests and responses for a single resource. Can this be achieved in RAML 0.8? Your response is much appreciated. Thank you!

Answer 1

您可以在RAML 0.8中拥有multiple responses，例如，一个用于200状态代码，一个用于404状态代码，等等。一个例子是：

/media/popular:
  displayName: Most Popular Media
  get:
    description: |
      Get a list of what media is most popular at the moment.
    responses:
      200:
        body:
          application/json:
            schema: !include instagram-v1-media-popular.schema.json
      503:
        description: |
          The service is currently unavailable or you exceeded the maximum requests
          per hour allowed to your application.
        body:
          application/json:
            schema: !include instagram-v1-meta-error.schema.json

您可以指定多个requests，但每个都可以指定不同的媒体类型。例如：

/jobs:
  post:
    description: Create a Job
    body:
      text/xml: !!null
      application/json: !!null

你不能在0.8中有多个examples。（在RAML 1中，您可以有多个示例）

包括RAML 0.8中相同资源的多个示例文件？

1 个答案: