ナレッジ
知識・原因・設定・過去のノウハウを探す場所です。やりたいこと・症状・ツール名で探せます。
「API 基本」の検索結果 17件
絞り込みを解除- APIの実務の基本(GET/POST/PUT/PATCH/DELETE・JSON・ヘッダー・認証/トークン・レート制限・ページング・タイムアウト・リトライ) APIは「URL+方法(GET/POST等)+ヘッダー(認証・形式)+本文(JSON)」で頼み、ステータスコードとJSONで答えが返る。認証キーはサーバー側だけに置きブラウザのJSに書かない。レート制限・ページング・タイムアウト・リトライを前提に作る。
- Webhookの基本(APIとの違い・受信URL・署名確認・再送・重複・失敗時) APIは自分から聞きに行く、Webhookは相手からイベント発生時に自サイトの受信URLへ知らせてくる。受信側は署名を確認して本物か確かめ、すぐ2xxを返し、同じ通知が再送・重複して届く前提で処理する。失敗はログに残す。
- CORSエラーの基本(別オリジン・ブラウザの制限・Access-Control-Allow-Origin・iframeとは別問題) ブラウザのJavaScriptから別オリジン(ドメイン・プロトコル・ポートが違う)のAPIを呼ぶと、相手のサーバーがAccess-Control-Allow-Originで許可していない限りブラウザが結果を読ませない。直すのは基本的にAPI側の設定か、自分のサーバー経由で呼ぶこと。ブラウザ側のコードだけで必ず解決できるものではない。iframeの表示可否は別問題。
- ネットショップ(EC)の作り方の選び方と必須ページ(BASE・STORES・Shopify・WooCommerce・特商法表記・API連携) 小規模ならBASE/STORES、拡張性ならShopify、WordPressに統合したいならWooCommerce(保守・セキュリティの負担大)。どれでも特商法表記・プライバシーポリシー・返品条件・最終確認画面の表示が必要。
- APIエラーの見方(200系・400・401・403・404・422・429・500系でどこを疑うか) 400系は「送った側」、500系は「相手側」の問題が基本。401は認証(キー・トークンの誤り・期限切れ)、403は権限・プラン・IP制限、404はURLや対象ID、429は回数制限、500系は相手の障害。まずエラー本文(JSON)を読む。
- JSONの読み方(object・array・key・value・文字列・数値・boolean・null)HP制作とAPI連携で困らない範囲 JSONは {} のobject(key: valueの組)と [] のarray(並び)でデータを表す。値は文字列("で囲む)・数値・true/false・null・object・array。keyは必ず"で囲む、末尾カンマ不可、コメント不可が典型的なつまずき。
- 外部サービスの組み込み方の違い(リンク・iframe・script埋め込み・ウィジェット・API)と自サイトCSSが効かない理由 外部サービスはリンク・iframe・script埋め込み・ウィジェット・APIの順に手軽→自由度高。iframeの中身は別サイトなので自サイトのCSSでは変えられない(枠の大きさだけ)。埋め込みは速度・Cookie・停止時の表示・高さ変化に注意。
- 予約サービスとHPの連携方法(リンク・予約ボタン・iframe・ウィジェット・API)と予約完了までの導線 多くの場合は「予約ボタン→外部予約ページへリンク」が最も簡単で壊れにくく、スマホでも操作しやすい。埋め込みはHP内で完結して見えるが、iframe内は小さく操作しにくくデザインも変えにくい。API連携は自由だが開発・保守が重い。
- 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で画面遷移後も記録を残す。
- WEB広告の基本(出稿の種類・CV計測・LP・表示ルール)とAdSense掲載の違い 出稿前にCV(キーイベント)を決めて計測を入れ、広告とGA4をリンクする。LPは広告文と内容を一致させる。景品表示法・ステマ規制(PR表記)に注意。自サイトに広告を載せるAdSenseは別物。
- HPに地図を載せる方法の使い分け(Google Mapsリンク・埋め込みiframe・地図画像・独自案内図) 通常のアクセス案内は「住所+Google Mapsへのリンク+埋め込みiframe1つ」で十分。駐車場・入口・分かりにくい道順は独自案内図を足す。埋め込みは横幅100%・スマホ高さ250〜350px前後・1ページ1つ・lazy。APIを使う高度な地図は別物(needs-review)。
- Elementor HTMLウィジェット2つで作る固定ページの構造とメタ(WP-CLIで再現) 1コンテナ+HTMLウィジェット3個(HTML①・HTML②・空)。_elementor_data と Astra/Elementor のメタを手本ページから複製して作る。REST APIでは保護メタを書けないのでWP-CLIを使う。
- SNS各社(Instagram・X・Facebook・YouTube・LINE)固有の仕様メモ(変化が速いので要確認) 各SNSの埋め込み・フィード・シェアの手段の目安。どれも仕様が変わりやすいので needs-review。作業時は必ず最新公式仕様を確認し、確認した日付と結果をここに追記する。
- Claude Codeの使い方の全体像(作業フォルダ・CLAUDE.md・knowledge・shell・SSH・並列の分担・再開・scratchpad・ログ) Claude Codeはコードを書くだけでなく、ファイル整理・検索・検査・自動処理・サーバー操作(SSH/WP-CLI)・ナレッジ整備に使える。作業フォルダとCLAUDE.mdでルールを固定し、knowledgeを検索してから作業、一時ファイルはscratchpad、中断したら状態確認から再開する。
- よく使うコマンド集(PowerShell・Claude Code起動・knowledge・WP-CLI・SSH) 作業フォルダへの移動、UTF-8表示、Claude Code起動、knowledge検索/索引/チェック、WP-CLIとSSHの読み取り専用確認、バックアップ→変更→検査の骨組み。秘密情報は書かない。
- SNSとHPの連携方法(Instagram等の投稿埋め込みとリンクの違い・アイコン・フィード・SNS⇔HPの導線・シェア) 「SNSへのリンク」は軽くて壊れにくく、SNSへ移動させる導線。「SNS投稿の埋め込み」はHP内で中身を見せられるが、外部JSで重く、仕様変更・ログイン必須化で表示されなくなることがある。まずリンク、埋め込みは価値がある場所に絞る。
- OGPとシェア導線の設定(og:image・twitter:card・シェアボタン・キャッシュ) 各ページに og:title / og:description / og:image(絶対URL・1200×630目安)/ og:url / og:type を出す。SEOプラグインで出すなら二重出力に注意。シェア画像が古いときはSNS側のキャッシュを再取得する。