RAML 1.0 включает в себя несколько файлов с ресурсами

Question

Я хочу определить ресурсы REST в нескольких файлах и включить их в один файл RAML. Я пробовал это, но всегда получаю ошибки RAML.

Main.raml #%RAML 1.0 title: Main RAML file to include All APIs version: v1 baseUri: http://api.samplehost.com /student: !include student.raml

student.raml

#%RAML 1.0 title: student APIs version: v1 baseUri: http://api.samplehost.com /student: get: # ..etc

но я получаю Неизвестную ошибку во включенном файле: Неизвестный узел: 'title' в Main.raml

Когда я удаляю 'title' из включенного файла 'student.raml', я получаю Неизвестный Отсутствует обязательное свойство 'title' в файле student.raml

Answer 1

Я думаю, что это невозможно сделать с RAML.

Для меня лучший способ решить эту проблему - использовать библиотеку RAML и использовать типы ресурсов, характеристики и типы, которые будут связаны с маршрутами, которые вы хотите раскрыть.

Для получения дополнительной информации см. Документацию RAML 1.0.

Answer 2

В соответствии с проблемой raml-org, ваш файл student.raml должен выглядеть примерно так:

получить:

Важной частью здесь является удаление первой строки

#%RAML 1.0