参考サイトやgit hubリポジトリ等でもかまいません。
※urlを用いた通常のweb apiのことではありません。
■設計
・RESTful な URL にしよう
・バージョンは URL に含めよう
・可能な限り JSON で返そう
翻訳: WebAPI 設計のベストプラクティス - Qiita
https://qiita.com/mserizawa/items/b833e407d89abd21ee72
RUST/RUBYのコントリビュータでRust for Rubyistsの作者でもあるSteve Klabnik氏は、“RESTful APIの99%はRoy Fielding氏のRESTの理念に完全には準拠していない”、と主張している。この見かけ上のRESTfulの慣習さえも破ることによって、DropboxのAPIは、いかなるセットモデルにも準拠しないものとなっている。
https://www.infoq.com/jp/news/2017/05/dropbox-api-scale
■実装
WebAPIの設計から実装まで~設計編~ -
Qiita https://qiita.com/takeokunnn/items/5442bb266fee6ee07799
WebAPIの設計から実装まで~実装編~ - Qiita
https://qiita.com/takeokunnn/items/c119e576a6c04d37e098
SwaggerでRESTful APIの管理を楽にする - Qiita
https://qiita.com/disc99/items/37228f5d687ad2969aa2
【連載】Swagger入門 - 初めてのAPI仕様管理講座 [1] Swaggerとは|開発ソフトウェア|IT製品の事例・解説記事
https://news.mynavi.jp/itsearch/article/devsoft/2395
質問文を編集しました。詳細はこちら。