Api-blueprint: Допускает ли APIARY несколько хостов в одном проекте

Также любопытно об этом. Мы используем несколько тестовых сред, и возможность переключаться между ними для поиска различий имеет решающее значение.

В настоящее время мы не поддерживаем это, но мы работаем над решениями, которые сделают это возможным в будущем.

Есть новости по этому поводу?

Есть ли уже какие-то решения этой проблемы?

Не публичный; мы проводим мозговой штурм о том, как решить эту проблему, и мы не уверены, что несколько HOST являются правильным решением, в отличие от разделения проблем проектирования и развертывания.

@Almad Я опишу свой вариант использования, чтобы дать обратную связь по этой проблеме.

Наш вариант использования Apiary - это просто встраивание красивой документации в нашу панель разработчика. Мы не планируем сейчас использовать какие-либо дополнительные функции, плагины или расширения. Мы используем несколько субдоменов для разных частей нашей системы (микросервисов), например, для аутентификации, выставления счетов, статистики, поиска ресурсов и т. Д. Как вы можете видеть, каждый субдомен отвечает за свой домен.

Что кажется самым привлекательным в Apiary, так это функциональность консоли. Вы можете описывать конечные точки, а конечные пользователи могут экспериментировать с ними через консоль. Он также добавляет возможность изменять языки и копировать пример кода на разных языках.

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

• Используйте разные документы для каждой микрослужбы. Но тогда документация разбросана по месту. За этим сложно уследить. И связать их между собой нетривиально.
• Ни в коем случае не используйте ссылку. Скройте консоль при встраивании документации. Минус конечно не показ консоли. Затем я остаюсь думать о следующем пункте:
• Самостоятельное создание дизайна документации API без использования сторонних разработчиков.

Ни один из вариантов не кажется отличным. Какие-нибудь рекомендации по нашему делу?

Для этого будет решение, но, к сожалению, я не могу говорить об этом и давать сроки, потому что SEC и юристы :(

Дает ли обозримое будущее достаточно надежды?

есть ли прогресс?

Поддержка объекта host была добавлена ​​в элементы API в первую очередь для поддержки сопоставления объектов сервера OAS3. Следите за обновлениями https://help.apiary.io/tools/interactive-documentation-v4/ .

Однако я не заметил никакого прогресса в поддержке API Blueprint.