結論
認証なしで Qiita API v2 を呼び続けて、1時間60回の上限に当たっていたのが原因でした。read_qiita だけのアクセストークンを発行して Authorization ヘッダーに付けたら、上限が1時間1,000回になり、止まっていた処理が通りました。
自分の Qiita 記事の本文・題名・タグを API で読み直して確かめる小さなスクリプトを、その日に何本も回していました。最初は普通に動いていたのに、途中から急に 403 が返るようになりました。
症状
同じスクリプトで、何件かは通ったのに、途中から次のエラーで止まりました。
File "C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.13_3.13.3824.0_x64__qbz5n2kfra8p0\Lib\urllib\request.py", line 613, in http_error_default
raise HTTPError(req.full_url, code, msg, hdrs, fp)
urllib.error.HTTPError: HTTP Error 403: Forbidden
呼んでいたのは公開記事を読む GET https://qiita.com/api/v2/items/<記事ID> だけです。URL もコードも変えていないのに、急に「権限がない」と言われた形になります。
環境
- Windows
- Python 3.13(Microsoft Store 版)の標準の
urllib.request - Qiita API v2。最初は認証なし(
User-Agentヘッダーだけ付けていた)
原因
Qiita の公式の API の説明(Qiita API v2 ドキュメント)に、利用回数の上限があります。
| 状態 | 上限 |
|---|---|
| 認証なし | IP アドレスごとに、1時間に60回まで |
| 認証あり(アクセストークンを付ける) | ユーザーごとに、1時間に1,000回まで |
この日は、記事の確認やタグの調査などで認証なしの呼び出しが積み重なり、60回を超えたところで 403 が返り始めました。エラーが 429 ではなく 403 なので、最初は権限の問題に見えて紛らわしいところです。
トークンを付けた後に回数の残りを読むと 999 / 1000 になっていて、上限が切り替わったことが確かめられました。
解決手順
- Qiita にログインして「設定 → アプリケーション」(
https://qiita.com/settings/applications)を開き、「新しくトークンを発行する」を押します。 - スコープは
read_qiitaだけ にチェックを入れます。記事を読むだけなら書き込みの権限(write_qiitaなど)は要りません。説明の欄には「記事確認(読み取りのみ)」のように用途が分かる名前を入れます。 - 「発行する」を押すと、トークンが一度だけ表示されます。すぐにコピーして、ファイルに1行で保存します(チャットや画面に貼らない)。
QIITA_TOKEN=***
- リクエストのヘッダーに
Authorization: Bearer <トークン>を足します。今回はヘッダーを作る小さな関数を1つの共通ファイルにまとめ、Qiita を呼ぶスクリプト3本をそれを使う形に替えました。考え方は次のとおりです(ファイルの場所は自分の環境に合わせてください)。
import os
def qiita_headers():
h = {'User-Agent': 'Mozilla/5.0'}
path = os.path.expanduser('~/.env_qiita') # トークンを保存したファイル
if os.path.exists(path):
for line in open(path, encoding='utf-8'):
if line.startswith('QIITA_TOKEN='):
h['Authorization'] = 'Bearer ' + line.split('=', 1)[1].strip()
return h
# 使う側
req = urllib.request.Request(f'https://qiita.com/api/v2/items/{item_id}', headers=qiita_headers())
- トークンを付けて呼び直すと、止まっていた残り2件も最後まで通りました。
再発防止・気づき
- 認証なしの60回は、確認の呼び出しを何度も挟むとすぐ使い切ります。1回の処理で同じ記事を何度も読まないよう、確認の呼び出しをまとめると減らせます。
- 待つだけでも1時間で60回に戻ります。急ぎでなければトークンは無くても回せます。
- トークンはパスワードと同じ扱いです。スコープは読み取りだけにして、値はファイルに置き、ログや画面に出さないようにしました。
- 複数のスクリプトや作業場所から Qiita を呼ぶなら、トークンのファイルは1か所にまとめ、ヘッダーを作る関数も共通にしておくと、差し替えが一度で済みます。