Api-blueprint: APIARYは同じプロジェクトで複数のホストを許可しますか

作成日 2018年03月08日  ·  9コメント  ·  ソース: apiaryio/api-blueprint

こんにちは、

同じプロジェクトに2つのホストを追加しようとしています。
ホスト1: https
ホスト2: https

現在、「HOST: https

前もって感謝します。 これから私を助けてください。

よろしく、
テジャ

Apiary.io

最も参考になるコメント

これに関する更新はありますか?

全てのコメント9件

これについても興味があります。 複数のテスト環境を使用しており、それらを切り替えて違いを見つけることができることが重要です。

現在、これをサポートしていませんが、将来的にこれを可能にするソリューションに取り組んでいます。

これに関する更新はありますか?

この問題の解決策はすでにありますか?

公開されたものではありません。 この問題を解決する方法についてブレインストーミングを行いますが、設計と展開の問題を切り離すのではなく、複数のホストが正しい解決策であるかどうかはわかりません。

@Almadこの問題に関してフィードバックを提供するために、ユースケースについて説明します。

私たちのApiaryのユースケースは、開発者ダッシュボードにきれいなドキュメントを純粋に埋め込んでいます。 現在、追加の機能、プラグイン、拡張機能を使用する予定はありません。 システムのさまざまな部分(マイクロサービス)に複数のサブドメインを使用します。たとえば、認証、請求、統計、リソースの取得などです。ご覧のとおり、各サブドメインはさまざまなドメインを担当しています。

Apiaryで最も魅力的なのは、コンソールの機能です。 エンドポイントを記述でき、エンドユーザーはコンソールを介してエンドポイントを試すことができます。 また、言語を変更したり、サンプルコードを別の言語でコピーしたりするオプションも追加されています。

ただし、複数のサブドメインを使用するオプションがない場合、いくつかのオプションしか残されません。

  • マイクロサービスごとに異なるドキュメントを使用します。 しかし、その後、ドキュメントは場所全体に散らばっています。 フォローするのは難しいです。 そして、それらの間のリンクは簡単ではありません。
  • 参照はまったく使用しないでください。 ドキュメントを埋め込む間、コンソールを非表示にします。 もちろん、欠点はコンソールが表示されないことです。 それから、私は次の箇条書きを考えたままになります:
  • サードパーティを使用せずに、APIドキュメントの設計を自分で作成します。

どのオプションも素晴らしいとは思えません。 私たちのケースへの推奨事項はありますか?

それに対する解決策はありますが、残念ながら、SECと弁護士がいるため、それについて話したり、タイムラインを示したりすることはできません:(

予見可能な未来は十分な希望を与えるでしょうか?

何か進展はありますか?

hostオブジェクトのサポートは、主にOAS3サーバーオブジェクトマッピングをサポートするためにAPI要素れましたhttps://help.apiary.io/tools/interactive-documentation-v4/レンダラーの更新にご

ただし、APIブループリントでのサポートの進捗は見られません。

このページは役に立ちましたか?
0 / 5 - 0 評価

関連する問題

Perni1984 picture Perni1984  ·  6コメント

spark-developer picture spark-developer  ·  12コメント

basickarl picture basickarl  ·  7コメント

rodriguise picture rodriguise  ·  11コメント

bazo picture bazo  ·  8コメント