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