ここ数日、API ブループリント、RAML、または Swagger を使用する必要があるかどうかを理解しようと努めてきました。
swagger には最大のコミュニティがあるように見えますが、よく見るとドキュメンテーションが大幅に不足しているように感じます (コードを何度も見て、現在のプロジェクトに統合することを余儀なくされました)、多くの github の問題とスタックオーバーフロー質問は未回答です。
ここで何かが足りない可能性はありますか? 私が欲しいのは、API ドキュメントを作成し、エンドポイントをテストするのに役立つツールだけです。
なぜ闊歩をサーバーロジックの一部にする必要があるのですか?? エディターでswaggerファイルを作成し、それらをUIに直接提供すると、壊れます..
私が知る限り、それはサーバーをわずかに遅くし、不器用に維持された多くの統合の存在を強制します:p ここで何が欠けていますか?