1

json の api をひたすら記述していると、いちいち仕様ページをみにいかなくても、形式データを提供してもらって、一括で api 処理を実装したくなります。

質問

REST + json な api サーバーの仕様記述において、機械的に処理可能な形式で記述できるものはありますか?いくつかあったとして、何がよく使われていますか?

1 件の回答 1

2

この回答は今後の情勢で変わる可能性はありますが、現在のところSwagger / Open API がデファクトスタンダードになりつつあります。

Swaggerをベースに、RESTful APIの記述標準化を目指す「Open API Initiative」が2015年に立ち上げられました。

Swaggerの中身の説明はQiita等の投稿に譲るとして、マシンリーダブルな仕様(Spec)からクライアント・サービスのコードを自動生成、その逆でコードからSpecの生成といったToolchainの世界が実現されています。

XML WebサービスにもあったSOAPみたいなものです。

この質問に回答するには、ログインする必要があります。

求めていた回答ではありませんか? のタグが付いた他の質問を参照する。