参考サイトや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
ありがとうございます。
2018/02/27 14:41:36ただ、提示して頂いた情報はurlを使用するweb apiについての情報のようです。
今回はその類ではなく、あくまでgoogle map apiのようなjsを使用するパターンを求めています。
もちろん、単なるjsではあるので、自分なりには構築したのですが、よりよい方法がないか模索しております。
is google maps API based on REST? - Stack Overflow
2018/02/27 15:00:42https://stackoverflow.com/questions/33590252/is-google-maps-api-based-on-rest