Проверка файла RAML

предположим, что у нас есть какой-то документ Swagger 2.0, например. http://petstore.swagger.io/v2/swagger.json

Я пытаюсь преобразовать его в другие форматы с помощью Apimatic. https://apimatic.io/transformer

Если я конвертирую документ Petstore Swagger в WADL, результат будет недействительным. Я проверил файл WADL на соответствие https://www.w3.org/Submission/wadl/wadl.xsd

Как правило, мне нужно преобразовать Swagger либо в WADL, либо в RAML. Я пытаюсь преобразовать Swagger в RAML с помощью Apimatic в качестве альтернативы, потому что преобразование в WADL не сработало.

Есть ли способ (онлайн или автономный инструмент) проверить правильность полученного файла RAML?

Спасибо.


validation swagger raml wadl
person Cimlman    schedule 05.10.2017    source источник

Ответы (1)


arrow_upward
4
arrow_downward

Онлайн: «Центр дизайна» по адресу https://anypoint.mulesoft.com.

В автономном режиме: перейдите на страницу https://raml.org/projects и щелкните вкладку "Дизайн".

Также в последнем проверьте вкладку «Утилиты», там есть преобразователи swagger в RAML.

person Pedro    schedule 05.10.2017
comment
Это кажется излишним для такой простой задачи, как проверка файла RAML. Ввод представляет собой файл RAML (возможно, недействительный). На выходе должно быть логическое значение: допустимо/недействительно. Если недействительно, было бы неплохо получить строковое сообщение с ошибкой проверки. Предоставьте четкие инструкции, как добиться этого с помощью API Manager, пожалуйста. - person Cimlman; 06.10.2017
comment
Не знаю онлайн-инструмента, который делает это. Парсеры на странице проектов raml.org делают именно это, они будут анализировать ваш RAML и выдавать ошибки проверки, как использовать, зависит от того, что вы выберете. Для диспетчера API: 1) вы регистрируетесь, 2) вы добавляете новый API, 3) открываете дизайнер, 4) вставляете свой RAML, 5) смотрите, есть ли ошибки проверки.... (если он загружает графическое представление на правильно что нет) - person Pedro; 06.10.2017
comment
Честно говоря, я до сих пор теряюсь. Зарегистрировался, добавил новый API...и не знаю где конструктор. Я загрузил скриншот. uschovna.cz/en/zasilka/QR5GI7HR43ANB9R8-74X - person Cimlman; 10.10.2017
comment
Да, извините, я вижу на этом экране раздел конструктора API, не знаю, почему он отличается от вашего. Я снова проверил регистрацию, и теперь вам нужно перейти в Центр дизайна (из меню в левом верхнем углу) и создать спецификацию API. - person Pedro; 10.10.2017