我正在使用 RAML 对 API 进行建模,我想知道是否可以对查询参数之间的依赖关系进行建模。
假设我们有一个对象集合。用户可以通过指定对象类型和状态来缩小查询结果的范围。这里有一点 RAML 应该做我刚才说的:
/objects:
- searchable:
queryParameters:
object-type:
enum: [Type1, Type2, Type3]
object-state:
enum: [State1, State2, State3]
现在上面的定义可能会让用户觉得可以使用他们想要的任何组合 - 不太正确的地方,如:
- 'Type1' 的对象可以只取 'State1',
- 'Type2' 的对象可以取 'State2'和 'State3',
- 'Type3' 的对象可以采用 'State1'、'State2'、'State3'。
有谁知道如何用 RAML 建模?