問題タブ [raml]

Eclipse で RAML を編集したいと考えています。RAML への Eclipse プラグインは見つかりませんでした。

RAML の Web サイト ( http://raml.org/projects.html ) には Sublime しかありません。

Eclipse で RAML を作成する素晴らしい経験を持つためのオプションを知っていますか?

Cloud Endpoint (Java) から生成されたファイルから、読み取り可能な形式で API ドキュメントを生成する効率的な方法を探しています。生成されるファイルは次のいずれかです。 - my_api.api - my_api*.discovery

次のようなもの: - https://github.com/kevinrenskers/raml2html#example-output

Swagger、API ブループリント、および RAML はすべて適切なオプションですが、エンドポイントで生成された API 記述子ファイルにはうまく適応していないようです。

どのような方法を使用していますか?

mule-AnyPoint Studio は初めてです。Java で mule-AnyPoint Studio を使用した API 統合に RAML を使用することは不可欠ですか。

ここ数日、API ブループリント、RAML、または Swagger を使用する必要があるかどうかを理解しようと努めてきました。

swagger には最大のコミュニティがあるように見えますが、よく見るとドキュメンテーションが大幅に不足しているように感じます (コードを何度も見て、現在のプロジェクトに統合することを余儀なくされました)、多くの github の問題とスタックオーバーフロー質問は未回答です。

ここで何かが足りない可能性はありますか? 私が欲しいのは、API ドキュメントを作成し、エンドポイントをテストするのに役立つツールだけです。

なぜ闊歩をサーバーロジックの一部にする必要があるのですか?? エディターでswaggerファイルを作成し、それらをUIに直接提供すると、壊れます..

私が知る限り、それはサーバーをわずかに遅くし、不器用に維持された多くの統合の存在を強制します:p ここで何が欠けていますか?

API Kit Router に着信スキーマを検証させる方法はありますか? RAML ファイルに次のものがありますが、受信スキーマを検証しません。

問題：

Swagger、RAML、または API ブループリント入力の HTML 表現を生成できる Java または JavaScript (またはおそらく Scala) のライブラリを探しています。

バックグラウンド：

アイデアは、API カタログとして機能する (Play Framework) Web アプリの一部として使用することです。API 仕様は API カタログのユーザーによって追加され、結果の HTML 表現が生成/表示されます。

API 仕様スタブも Java API を使用して作成できれば、さらに価値があります。API カタログ Web アプリには、API スタブを生成するときに使用したいデータ モデルがあります。

さらに、同じ (または関連する別の) ライブラリが、編集中にユーザーをサポートする API 仕様言語 (Swagger、RAML、API Blueprint など) の優れた HTML エディターを提供する場合、追加の価値が得られます。