質問: google mapのようなjsやhtmlを取り扱う、js api(というのか?)の設計や実装方法をご教示お願い出来ますでしょうか。 参考サイトやgit hubリポジトリ等でもかまいません。 ※urlを用いた通常のweb apiのことではありません。
回答: ■設計 > ・RESTful な URL にしよう > ・バージョンは URL に含めよう > ・可能な限り JSON で返そう > > 翻訳: WebAPI 設計のベストプラクティス - Qiita > > > > RUST/RUBYのコントリビュータでRust for Rubyistsの作者でもあるSteve Klabnik氏は、“RESTful APIの99%はRoy Fielding氏のRESTの理念に完全には準拠していない”、と主張している。この見かけ上のRESTfulの慣習さえも破ることによって、DropboxのAPIは、いかなるセットモデルにも準拠しないものとなっている。 > > > ■実装 WebAPIの設計から実装まで~設計編~ - Qiita WebAPIの設計から実装まで~実装編~ - Qiita SwaggerでRESTful APIの管理を楽にする - Qiita 【連載】Swagger入門 - 初めてのAPI仕様管理講座 [1] Swaggerとは|開発ソフトウェア|IT製品の事例・解説記事