google mapのようなjsやhtmlを取り扱う､js api(というのか？)の設計や実装方法をご教示お願い出来ますでしょうか｡参考ｻｲﾄやgit hubﾘﾎﾟｼﾞﾄﾘ等でもかまいません｡…

google mapのようなjsやhtmlを取り扱う､js api(というのか？)の設計や実装方法をご教示お願い出来ますでしょうか｡
参考ｻｲﾄや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