Api-blueprint: APIARY 是否允许同一项目中的多个主机

创建于 2018-03-08  ·  9评论  ·  资料来源: apiaryio/api-blueprint

你好,

我正在尝试在同一个项目下添加两个主机。
主机 1: https :
主机 2: https :

目前,我可以使用 "HOST: https://abc.com " 与一台主机一起工作,但我需要在同一个项目中配置两台主机。 有没有办法在同一个项目中定义两个主机?

提前致谢。 请帮我解决这个问题。

问候,
泰雅

Apiary.io

最有用的评论

这事有进一步更新吗?

所有9条评论

对这个也很好奇。 我们正在使用多个测试环境,能够在它们之间切换以发现差异至关重要。

我们目前不支持此功能,但我们正在研究解决方案,以便在未来实现这一点。

这事有进一步更新吗?

这个问题已经有任何解决方案了吗?

不是公开的; 我们对如何解决这个问题进行了头脑风暴,但我们不确定多个 HOST 是正确的解决方案,而不是解耦设计和部署问题。

@Almad我将描述我的用例以提供有关此问题的一些反馈。

我们的 Apiary 用例纯粹是将漂亮的文档嵌入到我们的开发人员仪表板中。 我们现在不打算使用任何附加功能、插件或扩展。 我们对系统的不同部分(微服务)使用多个子域,例如,身份验证、计费、统计、资源检索等。如您所见,每个子域负责不同的域。

Apiary 最吸引人的地方似乎是控制台功能。 您可以描述端点,最终用户可以通过控制台对其进行试验。 它还添加了一个选项来更改语言和复制不同语言的示例代码。

但是,没有使用多个子域的选项,我们只剩下几个选项:

  • 每个微服务使用不同的文档。 但是随后文档分散在整个地方。 很难跟上。 它们之间的联系并非微不足道。
  • 根本不要使用参考。 嵌入文档时隐藏控制台。 缺点当然是不显示控制台。 然后,我想到了下一个要点:
  • 在不使用第三方的情况下,自行构建 API 文档设计。

没有一个选项看起来很棒。 对我们的案例有什么建议吗?

会有一个解决方案,但不幸的是我不能谈论它并给出时间表,因为 SEC 和律师:(

可预见的未来会给予足够的希望吗?

有没有任何进展?

在 API 元素中添加了host对象的支持,主要是为了支持 OAS3 服务器对象映射。 请继续关注https://help.apiary.io/tools/interactive-documentation-v4/渲染器更新。

不过,我还没有看到 API Blueprint 支持方面的任何进展。

此页面是否有帮助?
0 / 5 - 0 等级

相关问题

pete001 picture pete001  ·  6评论

jmdacruz picture jmdacruz  ·  6评论

fgblomqvist picture fgblomqvist  ·  3评论

AlexKorovyansky picture AlexKorovyansky  ·  4评论

alronlam picture alronlam  ·  4评论