Question

在Swagger / OpenAPI 3.0中，可以重用枚举定义。

示例-共享颜色枚举定义：

  newComment.text = this.commentForm.value.text as string;

我想在RAML中做同样的事情，但是找不到解决方案。

Answer 1

在RAML 1中，您可以执行以下操作：

#%RAML 1.0
title: Example API
version: v1
types:
  platform:
    enum:
      - win
      - mac
/installer:
  get:
    queryParameters:
      platform:
        type: platform
/foo:
  get:
    queryParameters:
      platform:
        type: platform

您可以将类型定义分隔到它自己的文件中并包含它。使用此处描述的任何技术：https://github.com/raml-org/raml-spec/blob/master/versions/raml-10/raml-10.md/#modularization

此外，您可以定义具有查询参数的特征以在许多资源中重用。有关此内容的更多信息：https://github.com/raml-org/raml-spec/blob/master/versions/raml-10/raml-10.md/#resource-types-and-traits

重用RAML中的枚举定义

1 个答案: