ナレッジ
知識・原因・設定・過去のノウハウを探す場所です。やりたいこと・症状・ツール名で探せます。
「API」の検索結果 37件
絞り込みを解除- 認証情報(パスワード・秘密鍵・APIキー・トークン)はknowledgeに保存しない パスワード・秘密鍵の中身・APIキー・トークン・ドメイン移管の認証コード・DBパスワード(wp-config.phpの値)はknowledgeに書かない。書いてよいのは「どこにあるか」「どの種類か」まで。貼られていたら伏せ字にする。
- Google Maps Platform(API)を使う地図実装の注意(APIキー・課金・制限。料金は要確認) 複数ピン・独自デザイン・検索連動などはAPI実装になり、Google Cloudの請求先アカウント・APIキー・制限設定が必要。料金と無料枠は変わるので断定しない。通常のアクセス案内なら共有メニューの埋め込みiframeで足りる。
- APIの実務の基本(GET/POST/PUT/PATCH/DELETE・JSON・ヘッダー・認証/トークン・レート制限・ページング・タイムアウト・リトライ) APIは「URL+方法(GET/POST等)+ヘッダー(認証・形式)+本文(JSON)」で頼み、ステータスコードとJSONで答えが返る。認証キーはサーバー側だけに置きブラウザのJSに書かない。レート制限・ページング・タイムアウト・リトライを前提に作る。
- 外部サービスの組み込み方の違い(リンク・iframe・script埋め込み・ウィジェット・API)と自サイトCSSが効かない理由 外部サービスはリンク・iframe・script埋め込み・ウィジェット・APIの順に手軽→自由度高。iframeの中身は別サイトなので自サイトのCSSでは変えられない(枠の大きさだけ)。埋め込みは速度・Cookie・停止時の表示・高さ変化に注意。
- Claude Codeが途中で止まる(APIエラー・応答停止・サブエージェント待機・コンテキスト切れ) 止まったらまず「何が完了し、何が途中か」を調査だけさせてから再開する。API一時エラーはファイル状態を確認して再実行、安全チェックの停止は回避せず許可を求める、長いコマンドや大きいヒアドキュメントは分割する。
- 予約サービスとHPの連携方法(リンク・予約ボタン・iframe・ウィジェット・API)と予約完了までの導線 多くの場合は「予約ボタン→外部予約ページへリンク」が最も簡単で壊れにくく、スマホでも操作しやすい。埋め込みはHP内で完結して見えるが、iframe内は小さく操作しにくくデザインも変えにくい。API連携は自由だが開発・保守が重い。
- ログは推測の前に見る証拠(PHPログ・debug.log・Webサーバーログ・Console・APIレスポンス・Claude Codeログ)と保存時の注意 原因を推測する前に、該当する層のログを見る。PHP・WordPress・Webサーバーはサーバー側、JSはConsole、通信はNetworkとAPIの応答本文、AI作業はClaude Codeの出力・作業ファイル。ログには個人情報・トークンが含まれるので、共有・保存するときは伏せる。
- 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で画面遷移後も記録を残す。
- Webhookの基本(APIとの違い・受信URL・署名確認・再送・重複・失敗時) APIは自分から聞きに行く、Webhookは相手からイベント発生時に自サイトの受信URLへ知らせてくる。受信側は署名を確認して本物か確かめ、すぐ2xxを返し、同じ通知が再送・重複して届く前提で処理する。失敗はログに残す。
- ネットショップ(EC)の作り方の選び方と必須ページ(BASE・STORES・Shopify・WooCommerce・特商法表記・API連携) 小規模ならBASE/STORES、拡張性ならShopify、WordPressに統合したいならWooCommerce(保守・セキュリティの負担大)。どれでも特商法表記・プライバシーポリシー・返品条件・最終確認画面の表示が必要。
- 予約サービスを選ぶときに確認する項目(サービス固有の仕様・料金・連携方法・API。要確認) 予約サービスは業種(飲食・美容・医療・教室・宿泊・レンタル)で向き不向きがあり、料金・埋め込み可否・API・計測連携はサービスごとに違い変わりやすい。比較表の項目と確認記録の置き場所。
- JSONの読み方(object・array・key・value・文字列・数値・boolean・null)HP制作とAPI連携で困らない範囲 JSONは {} のobject(key: valueの組)と [] のarray(並び)でデータを表す。値は文字列("で囲む)・数値・true/false・null・object・array。keyは必ず"で囲む、末尾カンマ不可、コメント不可が典型的なつまずき。
- 作業の再開方法(途中停止・API Error・コンテキスト切れのあと) 再開時はまず現状を調べるだけにし、完了・途中・未着手・最後に成功した処理・止まっている処理を報告してから続ける。同じページを重複作成しない。
- APIエラーの見方(200系・400・401・403・404・422・429・500系でどこを疑うか) 400系は「送った側」、500系は「相手側」の問題が基本。401は認証(キー・トークンの誤り・期限切れ)、403は権限・プラン・IP制限、404はURLや対象ID、429は回数制限、500系は相手の障害。まずエラー本文(JSON)を読む。
- HPに地図を載せる方法の使い分け(Google Mapsリンク・埋め込みiframe・地図画像・独自案内図) 通常のアクセス案内は「住所+Google Mapsへのリンク+埋め込みiframe1つ」で十分。駐車場・入口・分かりにくい道順は独自案内図を足す。埋め込みは横幅100%・スマホ高さ250〜350px前後・1ページ1つ・lazy。APIを使う高度な地図は別物(needs-review)。
- CORSエラーの基本(別オリジン・ブラウザの制限・Access-Control-Allow-Origin・iframeとは別問題) ブラウザのJavaScriptから別オリジン(ドメイン・プロトコル・ポートが違う)のAPIを呼ぶと、相手のサーバーがAccess-Control-Allow-Originで許可していない限りブラウザが結果を読ませない。直すのは基本的にAPI側の設定か、自分のサーバー経由で呼ぶこと。ブラウザ側のコードだけで必ず解決できるものではない。iframeの表示可否は別問題。
- Gitの安全な使い方(commit前にstatus/diff・秘密情報をcommitしない・.gitignore・消しても履歴に残る) commit前に git status と git diff で対象と中身を確認し、git add . をむやみに使わない。.env・wp-config.php・鍵・APIキーは .gitignore で除外する。一度commitした秘密情報は、後で消しても履歴・コピー先に残るので、まずその認証情報を無効化・変更する。
- Elementor HTMLウィジェット2つで作る固定ページの構造とメタ(WP-CLIで再現) 1コンテナ+HTMLウィジェット3個(HTML①・HTML②・空)。_elementor_data と Astra/Elementor のメタを手本ページから複製して作る。REST APIでは保護メタを書けないのでWP-CLIを使う。
- HPトラブル時にDevToolsのどこを見るか(Elements・Styles・Computed・Console・Network・Application・レスポンシブ表示) 見た目・CSSはElements/Styles/Computed、JSのエラー・警告はConsole、ファイルやAPIの読み込み・ステータス・速度はNetwork、Cookie・保存データはApplication、スマホ幅はデバイスツールバー。症状から見る場所を選ぶ。
- SNS各社(Instagram・X・Facebook・YouTube・LINE)固有の仕様メモ(変化が速いので要確認) 各SNSの埋め込み・フィード・シェアの手段の目安。どれも仕様が変わりやすいので needs-review。作業時は必ず最新公式仕様を確認し、確認した日付と結果をここに追記する。
- ナレッジを追加・更新してサイトへ同期する 作業で分かったことを knowledge/ に足し、索引・チェックのあと guidepocket.net へ変更分だけ同期する。全件同期・全件監査はしない。
- AIに任せすぎてはいけない部分(公開判断・削除・設定変更・事実確認) 公開・検索公開・削除・上書き・プラグイン/設定変更・顧客向けの事実や料金はAIに判断させない。AIは準備・実行・検査まで、判断と承認は人が行う。
- よく使うコマンド集(PowerShell・Claude Code起動・knowledge・WP-CLI・SSH) 作業フォルダへの移動、UTF-8表示、Claude Code起動、knowledge検索/索引/チェック、WP-CLIとSSHの読み取り専用確認、バックアップ→変更→検査の骨組み。秘密情報は書かない。
- WordPress操作に Claude in Chrome(Chrome拡張)は使わない guidepocket.net の作成・公開・検査は SSH / WP-CLI で行う。Chrome拡張の接続を待ったり、認証情報を探したり、別の危険な方法を試したりしない。
- SNSとHPの連携方法(Instagram等の投稿埋め込みとリンクの違い・アイコン・フィード・SNS⇔HPの導線・シェア) 「SNSへのリンク」は軽くて壊れにくく、SNSへ移動させる導線。「SNS投稿の埋め込み」はHP内で中身を見せられるが、外部JSで重く、仕様変更・ログイン必須化で表示されなくなることがある。まずリンク、埋め込みは価値がある場所に絞る。
- Claude Codeの使い方の全体像(作業フォルダ・CLAUDE.md・knowledge・shell・SSH・並列の分担・再開・scratchpad・ログ) Claude Codeはコードを書くだけでなく、ファイル整理・検索・検査・自動処理・サーバー操作(SSH/WP-CLI)・ナレッジ整備に使える。作業フォルダとCLAUDE.mdでルールを固定し、knowledgeを検索してから作業、一時ファイルはscratchpad、中断したら状態確認から再開する。
- WordPressサイトのサーバー移転の流れ(旧環境確認→バックアップ→移行→事前確認→DNS切替→SSL→メール→検査→旧サーバーは残す) サーバー移転は、旧環境(DNS全レコード・メール・PHP版・プラグイン)を控え、フルバックアップ後に新サーバーへファイルとDBを移し、hostsで事前確認してからDNSを切り替える。SSL・メール・HTTP・フォーム・画像・リンクを確認し、旧サーバーはすぐ解約しない。
- 不正アクセス・改ざんが疑われるときの対応の流れ(状況保存→隔離→認証情報変更→範囲確認→クリーンな状態へ復旧→原因対策) 見覚えのない管理者・不審なファイル・勝手なリダイレクト・スパムページは侵入の兆候。まず状況を保存し、隔離を検討、全認証情報を変更、改ざん範囲を確認し、侵入前のクリーンなバックアップか正規ファイルで復旧、原因(脆弱性・パスワード)を塞いでから再確認する。
- AIにサーバー運用・障害対応を手伝わせるときの任せ方(ログ整理・差分確認・チェックリストはAI、DNS・削除・本番設定変更は人) ログ整理・設定差分・エラー文の分類・確認コマンド案・移行/バックアップのチェックリスト・原因候補の整理はAIに任せやすい。DNS変更・サーバー/DB削除・本番DB一括更新・鍵変更・メールDNS・ドメイン移管・本番サーバー設定はAIだけでやらせない。必ずバックアップ・確認・限定変更を伴う。
- WEB広告の基本(出稿の種類・CV計測・LP・表示ルール)とAdSense掲載の違い 出稿前にCV(キーイベント)を決めて計測を入れ、広告とGA4をリンクする。LPは広告文と内容を一致させる。景品表示法・ステマ規制(PR表記)に注意。自サイトに広告を載せるAdSenseは別物。
- WordPressのURL変更・ドメイン変更(サイトアドレス・DB内URL・シリアライズ・301・canonical・Search Console・GA4・メール) WordPressアドレス・サイトアドレスを変え、DB内の旧URLは wp search-replace(dry-run→本番)で置換、旧URLから新URLへページ単位で301。SQLの単純置換はシリアライズデータを壊す。Search Console・GA4・外部サービス・メールアドレスの変更も忘れない。
- 障害時は直前の変更を疑う・変更履歴を残す(更新・CSS・DNS・サーバー設定・PHP・SSL・外部サービス) 障害の多くは直前の変更がきっかけ。WordPress・プラグインの更新(自動更新含む)、CSS、DNS、サーバー設定、PHP、SSL、外部サービスの変更を最初に確認する。そのために、いつ・何を・どこで・変更前の値・戻し方を記録しておく。
- OGPとシェア導線の設定(og:image・twitter:card・シェアボタン・キャッシュ) 各ページに og:title / og:description / og:image(絶対URL・1200×630目安)/ og:url / og:type を出す。SEOプラグインで出すなら二重出力に注意。シェア画像が古いときはSNS側のキャッシュを再取得する。
- DevToolsのConsoleの見方(JavaScriptエラー・warning・CORS・404・外部script・フォーム/イベントが動かない) 赤はエラー(処理が止まっている可能性)、黄色は警告。1つのJSエラーで以降の処理(メニュー・スライダー・フォーム)が全部止まることがある。最初に出たエラーから、ファイル名と行を見る。AIに渡すときはURL内のトークンや個人情報を伏せる。
- WordPressが遅い主な原因(テーマ・Elementor・プラグイン・画像・キャッシュ・DB・外部通信・サーバー) 原因はテーマ・ページビルダー・プラグインのCSS/JS、画像、キャッシュ未設定、肥大化したDB、外部通信、サーバー性能。速度のためにプラグインを足し続けるのは矛盾。キャッシュ系・最適化系は1つに絞り、機能を重複させない。
- Claude CodeのAuto modeの考え方(自動で進む操作・確認が出る操作・確認画面で見るべき点) Auto modeはローカルの読み取り・検索・新規ファイル作成など安全な操作を自動で進め、削除・上書き・本番サーバー書き込み・外部サービスへの送信などは確認や停止になることがある。確認が出たのは失敗ではない。削除・本番変更・認証情報・大量上書きの確認は内容を読んでから許可する。
- サイトを別のサーバーへ移す サイトを新しいサーバーへ移すときの順番。旧環境の記録とバックアップ → 新サーバーで確認 → DNS切替 → SSL・メール・フォームの確認。旧サーバーはすぐ解約しない。