API BlueprintとSwaggerの特徴は何ですか？

Question

私はクラウドネイティブの方法でアプリケーションを開発しようとしています。私は自分のアプリケーションのAPIの最初の設計をしようとしています。

どのAPIドキュメントツールを使用しますか？ APIの最初の契約にはどちらが適していますか？むしろどちらが適していますか？

Answer 1

どちらのフォーマットもAPIの最初のアプローチに適していると思いますので、味の問題です（markdown対yaml/jsonベース）またはツールの制限です。

https://help.apiary.io/api_101/choosing-format/で概要を読むことができます。