Apicurio-studio: Ошибка страницы не найдена при попытке открыть существующую модель из github.

Привет, спасибо за отзыв. К сожалению, сейчас Apicurio не поддерживает чтение / запись YAML (как вы обнаружили). Для этого есть запрос функции:

https://github.com/Apicurio/apicurio-studio/issues/165

Сделать это несложно, но впереди в очереди еще несколько улучшений. :)

В качестве обходного пути вы можете попробовать преобразовать YAML в JSON, сохранить результат в GitHub, а затем открыть его. Раздражает, я знаю, но это сработает, пока мы не добавим дополнительные функции в apicurio.

Примечание: это все еще действительный отчет об ошибке, потому что нам нужны более точные сообщения об ошибках при добавлении / импорте API. Если ресурс не может быть найден (например, при импорте из URL-адреса), мы должны сообщить об этом ( не сообщать об ошибке «Страница не найдена»). Если ресурс существует, но имеет неправильный формат, мы должны сообщить об этом иначе.

Мне не удалось заставить работать свой OpenAPI 3 JSON или приведенный выше пример. Импорт с URL-адреса не работал для:

https://github.com/Apicurio/apicurio-studio/blob/master/back-end/hub-api/src/test/resources/io/apicurio/hub/api/beans/simple-api-3.0.json

или

https://github.com/david4096/data-object-schemas/blob/openapi3/openapi/data_objects_service.openapi.json

Привет @ david4096 - первый URL-адрес не работает, потому что по этому URL-адресу действительно нет контента. По крайней мере, когда я нажимаю на эту ссылку, файла нет. Фактически, для этого модуля нет папки resources в src/test :

https://github.com/Apicurio/apicurio-studio/tree/master/back-end/hub-api/src/test

Однако очевидно, что по второму URL-адресу есть контент. Причина, по которой он не работает в Apicurio, заключается в том, что мы, к сожалению, еще не поддерживаем извлечение контента из веток (только мастер). Здесь явно не хватает функциональности, так как поддерживать ветки несложно.

Тем не менее, я думаю, что мы идем в направлении возможности добавлять / импортировать дизайн API из произвольного URL-адреса, а не из различных систем управления версиями через их соответствующие API (это то, что мы делаем сейчас, исключительно в качестве удержания с тех пор, как мы больше полагались на эти системы для хранения данных). Я повышу приоритет функции «импорт из URL» и включу ее в следующую версию.

На данный момент в качестве обходного пути вы можете сохранить любые API-интерфейсы, которые вы хотите добавить / импортировать, в главную ветку любого репозитория github (возможно, создать репозиторий для этой цели) и импортировать оттуда.

Я добавил заявку на поддержку веток в системе контроля версий:

https://github.com/Apicurio/apicurio-studio/issues/222

Однако я думаю, что импорт контента с произвольного URL-адреса будет более полезной функцией, поэтому я сначала коснусь этого.

Привет, @EricWittmann, спасибо за объяснение!