エラーが読める人は一気に上に行く

自動化やAI活用を進めていると、必ずエラーに当たります。

ここで2種類の人に分かれます。

「エラーが出た。意味が分からない。詰んだ。」

「エラーが出た。コード見たら原因分かった。対処できる。」

この差が、一番大きな差です。

ステータスコードを覚える

HTTPの返答には番号があります。

主要なものだけ頭に入れてください：

2xx = 成功
– 200 → OK（成功）
– 201 → Created（作成成功）

4xx = あなた側の問題
– 400 → Bad Request（送ったデータが間違い）
– 401 → Unauthorized（認証されていない）
– 403 → Forbidden（権限がない）
– 404 → Not Found（URLが間違い）
– 429 → Too Many Requests（リクエストしすぎ）

5xx = サーバー側の問題
– 500 → Internal Server Error（サーバーが壊れてる）
– 503 → Service Unavailable（サービス停止中）

4xxが出たら自分のコードを見直す。5xxが出たら相手の問題。

よくある失敗パターン

401 が出る

→ アクセストークンが間違っているか、期限切れ

400 が出る

→ 送っているJSONの形式が間違っている

429 が出る

→ APIの呼び出し回数制限を超えた。少し待つ

403 が出る

→ そのAPIを使う権限が与えられていない

エラーをAIに投げる正しい方法

エラーが出たとき、これはNGです：

「エラーが出ました。どうすればいいですか？」

これがOKです：

「Instagram Graph APIに画像を投稿しようとしたら、以下のエラーが返ってきました：

{
  "error": {
    "message": "Invalid OAuth access token",
    "type": "OAuthException",
    "code": 190
  }
}

Pythonのrequestsライブラリを使っています。原因と対処法を教えてください。」

具体的なエラー情報を渡すだけで、AIの答えが一発で使えるものになります。

エラーログを残す習慣

自動化スクリプトには、必ずログを入れましょう：

try:
    response = requests.post(url, json=data)
    if response.status_code == 200:
        print("成功")
    else:
        print(f"失敗: {response.status_code} {response.text}")
except Exception as e:
    print(f"エラー: {e}")

エラーが起きたとき、「何が」「どこで」「どんな状態で」起きたか残しておく。

なぜエラーが読める人が上に行くか

エラーが読めない人：止まる

エラーが読める人：次に進む

これが積み重なると、圧倒的な差になります。

エンジニアが「問題解決が早い」のは、コードが書けるからではありません。エラーを見て原因を特定するのが速いからです。

結論

エラーは敵じゃない。

「何が間違っているか」を教えてくれる情報です。

読めるようになるだけで、AI活用のスピードが一気に上がります。

関連記事

• 実践APIを1回叩いてみる
• AIに通じる指示と通じない指示の違い