requestsでWeb APIを叩く(GET/POST、ステータスコード、.json())

Web APIとは、プログラム向けの窓口

私たちがブラウザでWebサイトを見るとき、裏では「このページをください」というリクエストをサーバーに送り、サーバーがHTMLを返しています。Web API(エーピーアイ)は、これの「プログラム向け」版です。人間が見るための画面ではなく、プログラムが処理しやすいデータ(多くはJSON)を返してくれる窓口だと考えてください。天気、為替、地図、そしてAIのサービスも、多くはWeb API経由で使います。

PythonからWeb APIを呼ぶときの定番が requests(リクエスツ)ライブラリです。標準ライブラリではないので、最初に pip install requests でインストールします。使い方は直感的で、GETで「取ってくる」、POSTで「送って処理してもらう」、という2つの動作を覚えれば大半のことができます。

import requests

# GET: サーバーからデータを取ってくる
response = requests.get("https://api.example.com/users/1")

print(response.status_code)  # 例: 200(成功)
data = response.json()       # レスポンスのJSONを辞書に変換
print(data["name"])

ステータスコード: 成功か失敗かを表す番号

APIは、結果を3桁の数字(ステータスコード)で教えてくれます。200番台は成功、400番台は「あなたのリクエストがおかしい」、500番台は「サーバー側の問題」です。この番号を確認せずに response.json() を呼ぶと、失敗時にエラーページ(HTML)をJSONとして読もうとして落ちることがあります。まず番号を見る、という習慣が大事です。

• 200 OK: 成功。データが返っている
• 201 Created: 成功。POSTで新しいデータが作られた
• 400 Bad Request: リクエストの形式が不正
• 401 Unauthorized: 認証が必要、またはAPIキーが違う
• 404 Not Found: 指定した対象が存在しない
• 429 Too Many Requests: 短時間に呼びすぎ(レート制限)
• 500 Internal Server Error: サーバー側の不具合

import requests

# POST: サーバーにデータを送って処理してもらう
payload = {"title": "買い物", "done": False}
response = requests.post(
    "https://api.example.com/todos",
    json=payload,          # 辞書を渡すと自動でJSONに変換して送る
    timeout=10,            # 10秒で応答がなければ諦める(重要)
)

if response.status_code == 201:
    created = response.json()
    print("作成成功:", created["id"])
else:
    print("失敗:", response.status_code, response.text)

res = requests.get(url)
data = res.json()  # 404やエラー時にここで例外

res = requests.get(url, timeout=10)
if res.status_code == 200:
    data = res.json()
else:
    print("エラー:", res.status_code)