ナレッジ
知識・原因・設定・過去のノウハウを探す場所です。やりたいこと・症状・ツール名で探せます。
「API エラー」の検索結果 19件
絞り込みを解除- Claude Codeが途中で止まる(APIエラー・応答停止・サブエージェント待機・コンテキスト切れ) 止まったらまず「何が完了し、何が途中か」を調査だけさせてから再開する。API一時エラーはファイル状態を確認して再実行、安全チェックの停止は回避せず許可を求める、長いコマンドや大きいヒアドキュメントは分割する。
- APIエラーの見方(200系・400・401・403・404・422・429・500系でどこを疑うか) 400系は「送った側」、500系は「相手側」の問題が基本。401は認証(キー・トークンの誤り・期限切れ)、403は権限・プラン・IP制限、404はURLや対象ID、429は回数制限、500系は相手の障害。まずエラー本文(JSON)を読む。
- ログは推測の前に見る証拠(PHPログ・debug.log・Webサーバーログ・Console・APIレスポンス・Claude Codeログ)と保存時の注意 原因を推測する前に、該当する層のログを見る。PHP・WordPress・Webサーバーはサーバー側、JSはConsole、通信はNetworkとAPIの応答本文、AI作業はClaude Codeの出力・作業ファイル。ログには個人情報・トークンが含まれるので、共有・保存するときは伏せる。
- CORSエラーの基本(別オリジン・ブラウザの制限・Access-Control-Allow-Origin・iframeとは別問題) ブラウザのJavaScriptから別オリジン(ドメイン・プロトコル・ポートが違う)のAPIを呼ぶと、相手のサーバーがAccess-Control-Allow-Originで許可していない限りブラウザが結果を読ませない。直すのは基本的にAPI側の設定か、自分のサーバー経由で呼ぶこと。ブラウザ側のコードだけで必ず解決できるものではない。iframeの表示可否は別問題。
- DevToolsのNetworkタブの見方(HTTPステータス・CSS/JS/画像・API(Fetch/XHR)・読み込み時間・キャッシュ) Networkを開いてから再読み込みし、種類(CSS/JS/Img/Fetch/XHR)で絞る。赤い行・404/500を探し、URLとステータスを確認。APIは行をクリックしてHeaders・Payload・Responseを見る。Disable cacheでキャッシュを除外、Preserve logで画面遷移後も記録を残す。
- JSONの読み方(object・array・key・value・文字列・数値・boolean・null)HP制作とAPI連携で困らない範囲 JSONは {} のobject(key: valueの組)と [] のarray(並び)でデータを表す。値は文字列("で囲む)・数値・true/false・null・object・array。keyは必ず"で囲む、末尾カンマ不可、コメント不可が典型的なつまずき。
- HPトラブル時にDevToolsのどこを見るか(Elements・Styles・Computed・Console・Network・Application・レスポンシブ表示) 見た目・CSSはElements/Styles/Computed、JSのエラー・警告はConsole、ファイルやAPIの読み込み・ステータス・速度はNetwork、Cookie・保存データはApplication、スマホ幅はデバイスツールバー。症状から見る場所を選ぶ。
- DevToolsのConsoleの見方(JavaScriptエラー・warning・CORS・404・外部script・フォーム/イベントが動かない) 赤はエラー(処理が止まっている可能性)、黄色は警告。1つのJSエラーで以降の処理(メニュー・スライダー・フォーム)が全部止まることがある。最初に出たエラーから、ファイル名と行を見る。AIに渡すときはURL内のトークンや個人情報を伏せる。
- APIの実務の基本(GET/POST/PUT/PATCH/DELETE・JSON・ヘッダー・認証/トークン・レート制限・ページング・タイムアウト・リトライ) APIは「URL+方法(GET/POST等)+ヘッダー(認証・形式)+本文(JSON)」で頼み、ステータスコードとJSONで答えが返る。認証キーはサーバー側だけに置きブラウザのJSに書かない。レート制限・ページング・タイムアウト・リトライを前提に作る。
- 外部サービスの組み込み方の違い(リンク・iframe・script埋め込み・ウィジェット・API)と自サイトCSSが効かない理由 外部サービスはリンク・iframe・script埋め込み・ウィジェット・APIの順に手軽→自由度高。iframeの中身は別サイトなので自サイトのCSSでは変えられない(枠の大きさだけ)。埋め込みは速度・Cookie・停止時の表示・高さ変化に注意。
- 作業の再開方法(途中停止・API Error・コンテキスト切れのあと) 再開時はまず現状を調べるだけにし、完了・途中・未着手・最後に成功した処理・止まっている処理を報告してから続ける。同じページを重複作成しない。
- AIにサーバー運用・障害対応を手伝わせるときの任せ方(ログ整理・差分確認・チェックリストはAI、DNS・削除・本番設定変更は人) ログ整理・設定差分・エラー文の分類・確認コマンド案・移行/バックアップのチェックリスト・原因候補の整理はAIに任せやすい。DNS変更・サーバー/DB削除・本番DB一括更新・鍵変更・メールDNS・ドメイン移管・本番サーバー設定はAIだけでやらせない。必ずバックアップ・確認・限定変更を伴う。
- 不正アクセス・改ざんが疑われるときの対応の流れ(状況保存→隔離→認証情報変更→範囲確認→クリーンな状態へ復旧→原因対策) 見覚えのない管理者・不審なファイル・勝手なリダイレクト・スパムページは侵入の兆候。まず状況を保存し、隔離を検討、全認証情報を変更、改ざん範囲を確認し、侵入前のクリーンなバックアップか正規ファイルで復旧、原因(脆弱性・パスワード)を塞いでから再確認する。
- 障害時は直前の変更を疑う・変更履歴を残す(更新・CSS・DNS・サーバー設定・PHP・SSL・外部サービス) 障害の多くは直前の変更がきっかけ。WordPress・プラグインの更新(自動更新含む)、CSS、DNS、サーバー設定、PHP、SSL、外部サービスの変更を最初に確認する。そのために、いつ・何を・どこで・変更前の値・戻し方を記録しておく。
- ナレッジを追加・更新してサイトへ同期する 作業で分かったことを knowledge/ に足し、索引・チェックのあと guidepocket.net へ変更分だけ同期する。全件同期・全件監査はしない。
- SNSとHPの連携方法(Instagram等の投稿埋め込みとリンクの違い・アイコン・フィード・SNS⇔HPの導線・シェア) 「SNSへのリンク」は軽くて壊れにくく、SNSへ移動させる導線。「SNS投稿の埋め込み」はHP内で中身を見せられるが、外部JSで重く、仕様変更・ログイン必須化で表示されなくなることがある。まずリンク、埋め込みは価値がある場所に絞る。
- WordPressサイトのサーバー移転の流れ(旧環境確認→バックアップ→移行→事前確認→DNS切替→SSL→メール→検査→旧サーバーは残す) サーバー移転は、旧環境(DNS全レコード・メール・PHP版・プラグイン)を控え、フルバックアップ後に新サーバーへファイルとDBを移し、hostsで事前確認してからDNSを切り替える。SSL・メール・HTTP・フォーム・画像・リンクを確認し、旧サーバーはすぐ解約しない。
- WordPressが遅い主な原因(テーマ・Elementor・プラグイン・画像・キャッシュ・DB・外部通信・サーバー) 原因はテーマ・ページビルダー・プラグインのCSS/JS、画像、キャッシュ未設定、肥大化したDB、外部通信、サーバー性能。速度のためにプラグインを足し続けるのは矛盾。キャッシュ系・最適化系は1つに絞り、機能を重複させない。
- サイトを別のサーバーへ移す サイトを新しいサーバーへ移すときの順番。旧環境の記録とバックアップ → 新サーバーで確認 → DNS切替 → SSL・メール・フォームの確認。旧サーバーはすぐ解約しない。