API documentation tools
とは
REST API等のAPIにおいて、コードからAPIのドキュメントを生成したりするツール
エンドポイント毎のリクエストのパラメーターや、レスポンスのフォーマット等をドキュメント化出来る
逆にエンドポイントの仕様を先に記述して、コードを生成するというパターンもある
単純にドキュメントを生成出来るというだけでも嬉しいが、ある仕様に沿うことでその仕様に準じた他ツールを利用できるというメリットがある
よく使われるのは、フロントエンドからAPIを叩く時に、そのエンドポイントでどんなパラメーターが使えるのか、レスポンスはどんなフォーマットで返ってくるのかを型で制限出来る等
比較
恐らく最も知られている仕様