バックエンド 2025.12.07

API連携エラーでサイトが真っ白！緊急復旧の手順書

約6分で読めます

API連携エラーでWebサイトが表示されない緊急事態に、技術者でなくても対応できる具体的な復旧手順を20年の実績から解説します。

こんな緊急事態、経験ありませんか？

朝一番にWebサイトを確認すると画面が真っ白。昨日まで正常に動いていたのに、突然「サーバーエラー」や「503 Service Unavailable」が表示される。お客様からも「サイトが見れない」という連絡が次々と...

これは多くの場合、API連携エラーが原因です。横浜で20年以上Web制作を手がけてきた私たちFivenine Designでも、このような緊急対応を数多く経験してきました。

実際にあった緊急事態とその教訓

ある横浜の製造業クライアント様で、朝9時頃から突然ECサイトが表示されなくなりました。原因は決済APIの認証キーが期限切れになったことでした。

問題の経緯：

  • 決済代行会社のAPI認証キーが1年で自動更新される設定だった
  • しかし、サーバー側の設定で新しいキーの取得に失敗
  • 結果として全ての商品ページでエラーが発生

この事態で分かったのは、技術者でなくても初期対応ができる体制の重要性でした。適切な手順があれば、被害を最小限に抑えることができます。

緊急時の対応手順（5分でできる初期診断）

1. エラーの種類を特定する

まず、どのようなエラーが表示されているかを確認しましょう。

よくあるエラーパターン：

  • 500 Internal Server Error → サーバー内部エラー
  • 503 Service Unavailable → サービス利用不可
  • 404 Not Found → ページが見つからない
  • 白い画面（何も表示されない） → 致命的エラー

2. 管理画面にアクセスできるかチェック

WordPressやシステムの管理画面にログインできるかを確認します。

管理画面URL例：
https://yoursite.com/wp-admin/  （WordPress）
https://yoursite.com/admin/     （カスタムシステム）

もし管理画面にアクセスできれば、サーバー自体は生きている可能性が高いです。

3. プラグインやAPI連携機能を一時停止

管理画面にアクセスできた場合は、以下の順序で機能を停止してみてください：

WordPressの場合：

  1. プラグインを全て無効化
  2. テーマをデフォルトに変更
  3. サイトが復旧するかチェック

カスタムシステムの場合：

  1. 外部API連携機能を一時停止
  2. キャッシュをクリア
  3. サイトが復旧するかチェック

根本原因の特定方法

エラーログを確認する

サーバーのエラーログは問題解決の重要な手がかりです。一般的な確認場所：

# 一般的なエラーログの場所
/var/log/apache2/error.log
/var/log/nginx/error.log
/path/to/your/application/storage/logs/laravel.log

よくあるAPI関連エラーメッセージ：

  • "cURL error 28: Connection timed out" → API接続タイムアウト
  • "401 Unauthorized" → API認証エラー
  • "429 Too Many Requests" → API利用制限に達している

API接続テストの実行

簡単なAPI接続テストで問題を特定できます：

<?php
// 簡単なAPI接続テスト
$api_url = 'https://api.example.com/test';
$response = wp_remote_get($api_url, array(
    'timeout' => 10,
    'headers' => array(
        'Authorization' => 'Bearer YOUR_API_KEY'
    )
));

if (is_wp_error($response)) {
    echo '接続エラー: ' . $response->get_error_message();
} else {
    echo 'ステータスコード: ' . wp_remote_retrieve_response_code($response);
}
?>

応急処置による一時復旧

メンテナンスページの設置

完全復旧まで時間がかかる場合は、メンテナンスページを設置しましょう：

<!DOCTYPE html>
<html>
<head>
    <title>メンテナンス中</title>
</head>
<body>
    <h1>只今メンテナンス中です</h1>
    <p>ご迷惑をおかけして申し訳ございません。<br>
    復旧まで今しばらくお待ちください。</p>
</body>
</html>

キャッシュ機能による部分復旧

API連携が復旧するまでの間、キャッシュされたデータで最低限のサイト表示を維持する方法もあります。

よくある失敗と注意点

20年の経験で見えてきた「やりがちなミス」があります：

1. 慌てて設定を変更してしまう

「とりあえず何かしなければ」と焦って設定を変更すると、問題が複雑化することがあります。必ずバックアップを取ってから作業しましょう。

2. エラーログを確認せずに推測で対応

「きっとこれが原因だろう」という推測での対応は時間の無駄になりがちです。まずはエラーログで事実を確認することが重要です。

3. 一度に複数の対処を実行

複数の対処を同時に行うと、何が効果的だったかが分からなくなります。一つずつ順序立てて対応することが結果的に早期解決につながります。

予防策：同じトラブルを繰り返さないために

定期的な監視体制の構築

  • API接続状況の定期チェック
  • 認証キーの有効期限管理
  • アクセス制限の監視

バックアップとロールバック体制

# 定期バックアップの例（cron設定）
0 2 * * * /usr/local/bin/backup_script.sh

万が一の時に素早く前の状態に戻せる体制を整えておくことで、被害を最小限に抑えることができます。

技術者に相談すべきタイミング

以下の状況では、無理をせず専門家に相談することをおすすめします：

  • 上記の手順を試しても復旧しない
  • エラーログの内容が理解できない
  • データベースに関わるエラーが発生している
  • セキュリティに関わる可能性がある

横浜のクライアント様でも、「自分で何とかしようと思って余計にひどくなってしまった」というケースを何度も見てきました。早めの相談が結果的にコストも時間も節約につながります。

まとめ：まず何をすべきか

API連携エラーでサイトが表示されなくなった時は：

  1. 5分以内に初期診断（エラー種類・管理画面確認）
  2. 応急処置でサイト機能を一時復旧
  3. エラーログで根本原因を特定
  4. 必要に応じて専門家に相談

この手順を踏むことで、パニックにならずに適切な対応ができるようになります。

もしこのような緊急事態でお困りの際は、横浜のFivenine Designまでお気軽にご相談ください。20年以上の実績で培った緊急対応ノウハウで、迅速に問題解決いたします。

この記事をシェア

関連記事

ブログ一覧に戻る