質問: json の api をひたすら記述していると、いちいち仕様ページをみにいかなくても、形式データを提供してもらって、一括で api 処理を実装したくなります。 ### 質問 REST + json な api サーバーの仕様記述において、機械的に処理可能な形式で記述できるものはありますか?いくつかあったとして、何がよく使われていますか?
回答: この回答は今後の情勢で変わる可能性はありますが、現在のところSwagger / Open API がデファクトスタンダードになりつつあります。 Swaggerをベースに、RESTful APIの記述標準化を目指す「Open API Initiative」が2015年に立ち上げられました。 Swaggerの中身の説明はQiita等の投稿に譲るとして、マシンリーダブルな仕様(Spec)からクライアント・サービスのコードを自動生成、その逆でコードからSpecの生成といったToolchainの世界が実現されています。 XML WebサービスにもあったSOAPみたいなものです。