---
# System prepended metadata

title: Web API The Good Parts

---

# Web API The Good Parts

## 前提
本書は、2014年に発売された書籍であり、一部情報ソースが古い可能性があります。

## 1章 Web APIとは何か
### 概要
本書全体の導入部分として、WebAPIを取り巻く現状と、本書の内容をそのように活かすことができるかについてまとめてある

### 内容
- APIのパターンは、以下のようなものがあると紹介されています
    - 公開しているWebサービスのデータや機能のAPI公開
    - 他のページに貼り付けてあるウェジェットの公開
    - モダンなWebアプリケーションの構築
    - スマホアプリケーションの開発
    - ソーシャルゲームの開発
    - 社内システムの連携
- **WebAPIを公開していないなら、すぐにその公開を検討する**
    - "その"サービスでできること全てをAPIで公開することで、自らの利益に貢献することができる
    - "その"サービスを通じて、世の中に何をを広げたいのだとすれば、WebAPIを公開することで、多くのタイミングでサービスが利用される
- **WebAPIを美しく設計する**
    - "API全体"で仕様が統一されているものは、仕様に従う
    - 仕様が存在しないものは、（なるべく）デファクトスタンダードに従う
    > デファクトスタンダードとは、公的な標準化機関からの認証ではなく、市場における企業間の競争によって、業界の標準として認められるようになった規格のこと。

## 2章 エンドポイントの設計とリクエストの形式
### 概要
WebAPIは、基本的にリクエストとレスポンスで構成されているが、2章ではそのうち**リクエスト**、つまりクライアントからサーバに対して行うアクセスの設計について述べる
リクエストの方法とは、クライアントからサーバに送信する方法と、それを受け取るサーバ側のエンドポイント(URI)の設計が含まれる

### 内容
- 覚えやすく、どんな機能を持つかがひと目でわかるエンドポイントにする
- 適切なHTTPメソッドを利用する
- 適切な英単語を利用し、単数形、複数形に注意する
- 認証にはOAuth2.0を使う

### 3章 レスポンスデータの設計
- JSONPの現在の状況

### 4章 HTTPの仕様を最大限利用する

### 5章 設計変更をしやすいWeb APIを作る

### 6章 堅牢なWeb APIを作る