Api RAML:引用资源中的参数

Api RAML:引用资源中的参数,api,mime-types,raml,Api,Mime Types,Raml,我正在用RAML编写API规范,想知道是否可以引用uri参数来创建动态mime类型。类似于 baseUri: http://api.mycompany.com/{version} /first_resource: get: responses: 200: body: application/custom.mime.type.{version}+json 目前(V0.8)此类行为不属于本协议的一部分 您在示例代码中所追求的可能会为开发

我正在用RAML编写API规范,想知道是否可以引用uri参数来创建动态mime类型。类似于

baseUri: http://api.mycompany.com/{version}

/first_resource:
  get:
    responses:
      200:
        body:
          application/custom.mime.type.{version}+json
目前(V0.8)此类行为不属于本协议的一部分

您在示例代码中所追求的可能会为开发人员添加一条错误路径,您的服务器实现必须满足这一点:如果在
http://api.mycompany.com/v1生成了
,但由于某些原因,它包含一个
内容类型:custom.mime.Type.v2+json
-头

当使用自定义版本的MIME类型时,我的建议是使用一个无版本的URL,以通过设计避免这种情况。对于无法发送所需标题的客户端,您仍然可以使用查询字符串或您所拥有的内容提供回退