在RAML中使用外部架构

Question

我有一个RAML规范，我想在其他文件夹中的其他项目中引用JSON模式。

我怎么做？

我只能发现您可以通过url这样引用架构：

{
    "$schema":"http://json-schema.org/draft-04/schema#",
    "title":"error",
    "description":"schema for api specified errors",
    "type":"object",
    "properties":
{

潜在的解决方案 ：

title: BirthdayParty
baseUri: http://bouncyouse.com/{version}
schemas:
 - DaddySchema !include C:/projects/schema/Daddy1
 - MommySchema !include C:/projects/schema/Mommy2

Answer 1

在RAML中，您可以包括来自相同或不同文件夹的不同JSON模式。 例如：

title: GitHub API
version: v3
baseUri: https://api.github.com
mediaType:  application/json
schemas:
  - User:  schema/user.json
  - Users: schema/users.json
  - Org:   schema/org.json
  - Orgs:  schema/orgs.json
/root:
   post:
      body:
          schema: User

要在JSON模式中进行引用，可以使用id和$ ref ：

• http://json-schema.org/latest/json-schema-core.html#anchor25
• http://spacetelescope.github.io/understanding-json-schema/structuring.html