RESTについて
- 読むべき技術書
Webを支える技術 -HTTP、URI、HTML、そしてREST (WEB+DB PRESS plus)
- 作者: 山本陽平
- 出版社/メーカー: 技術評論社
- 発売日: 2010/04/08
- メディア: 単行本(ソフトカバー)
- 購入: 143人 クリック: 4,320回
- この商品を含むブログ (183件) を見る
JSONについて
ステータスコード
結構悩むステータスコードについて
HTTP レスポンスステータスコード - HTTP | MDN
【図解】RESTful WebサービスにおけるHTTPステータスコード : アジャイル株式会社
RESTful API設計におけるHTTPステータスコードの指針 - Qiita
WebAPIでエラーをどう表現すべき?15のサービスを調査してみた - Qiita
OAuth
The OAuth 2.0 Authorization Framework: Bearer Token Usage(日本語)
OAuth 認証を真面目に考える | DevelopersIO
OAuth 2.0 の仕組みと認証方法 | murashun.jp
OAuth2.0とOpenID Connectの概要 - Qiita
- OAuthについて書いてある数少ない本
OAuth徹底入門 セキュアな認可システムを適用するための原則と実践
- 作者: Justin Richer,Antonio Sanso,Inc. Authlete,須田智之
- 出版社/メーカー: 翔泳社
- 発売日: 2019/01/30
- メディア: 単行本(ソフトカバー)
- この商品を含むブログを見る
API設計について
API 設計ガイド | Cloud API | Google Cloud
API 設計ガイダンス - Best practices for cloud applications | Microsoft Docs
APIテクニカルガイドブック 2019年(平成31年)3月28日 内閣官房情報通信技術(IT)総合戦略室
翻訳: WebAPI 設計のベストプラクティス - Qiita
- マストです
- 作者: 水野貴明
- 出版社/メーカー: オライリージャパン
- 発売日: 2014/11/21
- メディア: 大型本
- この商品を含むブログ (9件) を見る
APIドキュメントツール
1. API Blueprint
API Blueprint を使って Web API の仕様書を書こう (フェンリル | デベロッパーズブログ)
【API Blueprintの使い方】Web APIの仕様書を書く・読む・実行する | DevelopersIO
Webエディター
Platform for API Design, Development & Documentation | Apiary
※ドキュメント作成に必要なプラグインが揃っているので、VSCodeで書くのがおすすめ日本語のサンプル
Sample of API Blueprint document · GitHub
※記述法がわからなくて困ったときでも、よくよく見るとちゃんとドキュメントに書いてあるので注意すること