Api RAML:表示具有固定值枚举的URL参数

Api RAML:表示具有固定值枚举的URL参数,api,raml,Api,Raml,在我的RAML 1.0规范中,我想表示一个uriParameter,其值是枚举令牌的集合列表之一。例如,\u格式只能是以下格式之一:csv、json或ttl 从阅读RAML规范中可以看出,除非包含JSON模式声明,否则目前不可能做到这一点。RAML是否可以在没有JSON模式的情况下对枚举进行编码,如果可以,如何进行编码?是的,您可以使用: 数据类型可以描述基本或资源URI参数、查询参数、请求或响应头、请求或响应正文。数据类型是内置的或自定义的。内置类型可以在API需要数据的任何地方使用。自定义类

在我的RAML 1.0规范中,我想表示一个
uriParameter
,其值是枚举令牌的集合列表之一。例如,
\u格式
只能是以下格式之一:
csv
json
ttl

从阅读RAML规范中可以看出,除非包含JSON模式声明,否则目前不可能做到这一点。RAML是否可以在没有JSON模式的情况下对枚举进行编码,如果可以,如何进行编码?

是的,您可以使用:

数据类型可以描述基本或资源URI参数、查询参数、请求或响应头、请求或响应正文。数据类型是内置的或自定义的。内置类型可以在API需要数据的任何地方使用。自定义类型可以通过扩展内置类型来定义,也可以像内置类型一样命名和使用

例如:

#%RAML 1.0
title: bla
types:
  foo:
    type: string
    enum: [ json, csv, ttl ]
/bar/{_format}:
  uriParameters:
    _format:
      type: foo
  get: