Tbpgr Blog

Ruby プログラマ tbpgr(てぃーびー) のブログ

Ruby + Web APIに関わる情報のリンク集

f:id:tbpg:20150719231649j:plain

Ruby + Web APIに関わる情報をまとめます。

Microservicesの需要が高まる昨今、Web APIの導入に対する需要も当然高まっていると思います。
導入企業の情報を見るとRubyを活用しているところが多いように感じます。
そこで、Ruby+Web APIに関わる情報を調べてみることにしました。

認証, 認可

Web APIの話では無いのだが、認証を切り出すケースは多いだろうということで。

qiita.com

エラー処理

qiita.com

API Document

qiita.com

Grape

RESTful APIを簡単に作るためのDSLを備えたRubyフレームワーク

Grape - GitHub

Grape関連情報

dev.classmethod.jp

qiita.com

qiita.com

qiita.com

スライド

Ruby Web API Tools

API Builders - The Ruby Toolbox

JSON Schema

JSONスキーマ定義を明確にする。
これによって、ドキュメントの生成やValidationなどを支援することができる。

json-schema.org

JsonWorld

モデルからJSON Schemaを生成する。

JsonWorld - GitHub

qiita.com

Jdoc

JSON Schemaを表現するデータ構造をMarkdownに変換する。

Jdoc - GitHub

qiita.com

Rack::JsonSchema

JSON Schemaを利用してサーバに入力されるHTTPリクエストを検閲する。

Rack::JsonSchema - GitHub

qiita.com

Aries

JSON SchemaからSwiftAPIクライアントを自動生成する。

yss44.hatenablog.com

Slides

書籍

Web API: The Good Parts

Web API: The Good Parts

WEB+DB PRESS Vol.82

WEB+DB PRESS Vol.82

  • 作者: 山口徹,Jxck,佐々木大輔,横路隆,加来純一,山本伶,大平武志,米川健一,坂本登史文,若原祥正,和久田龍,平栗遵宜,伊藤直也,佐藤太一,高橋俊幸,海野弘成,五嶋壮晃,佐藤歩,吉村総一郎,橋本翔,舘野祐一,中島聡,渡邊恵太,はまちや2,竹原,河合宜文,WEB+DB PRESS編集部
  • 出版社/メーカー: 技術評論社
  • 発売日: 2014/08/23
  • メディア: 大型本
  • この商品を含むブログ (1件) を見る

Web APIに関して気になる所

  • RubyでWeb APIを実装する場合の主流は?
    • Rails+Jsonでシンプルに作る?
    • Grapeを利用する?
    • その他?
  • API Clientの実装
    • 手動
    • JSON Schemaなどを元に半自動生成+手動
    • JSON Schemaなどを元に全自動生成
  • APIドキュメント
    • 手動
    • Jdocや類似の仕組みで自動生成