在RAML中使用外部模式

Question

我有一个RAML规范,我想在不同的文件夹中的其他项目中引用JSON模式.

我怎么做？

我只能发现你可以通过网址引用架构,如下所示:

{
    "$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