在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