Vapor Trail

明るく楽しく元気よく

大して知識もないのにAPI設計するときに役立つサイト一覧

RESTについて

yohei-y:weblog: REST 入門

JSONについて

JSON データの操作 - Web 開発を学ぶ | MDN

Google JSON Style Guide

ステータスコード

結構悩むステータスコードについて

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

一番分かりやすい OAuth の説明 - Qiita

OAuth2.0とOpenID Connectの概要 - Qiita

API設計について

API 設計ガイド  |  Cloud API  |  Google Cloud

API 設計ガイダンス - Best practices for cloud applications | Microsoft Docs

APIテクニカルガイドブック 2019年(平成31年)3月28日 内閣官房情報通信技術(IT)総合戦略室

翻訳: WebAPI 設計のベストプラクティス - Qiita

WebAPIの設計から実装まで〜設計編〜 - Qiita

APIドキュメントツール

1. API Blueprint

API Blueprint を使って Web API の仕様書を書こう (フェンリル | デベロッパーズブログ)

【API Blueprintの使い方】Web APIの仕様書を書く・読む・実行する | DevelopersIO

2. Swagger

開発効率を上げる!Swaggerの記法まとめ - ZOZO Technologies TECH BLOG

Swaggerの記法まとめ - Qiita