APIリクエストビルダー
なぜAPIリクエストビルダーを使うのか?
REST APIのテストには通常PostmanやInsomniaのインストールやcurlコマンドの記述が必要です。当ブラウザベースHTTPクライアントはインストール不要 — 開いてすぐにリクエストを送信できます。すべてのHTTPメソッド、カスタムヘッダー、JSONボディ、クエリパラメータをサポートしています。
すべてのHTTPメソッド
カスタムヘッダーとJSON/フォームボディ付きでGET, POST, PUT, PATCH, DELETEをサポート
フォーマット済みレスポンス
レスポンスボディはインデント付きで自動表示、ステータスコードとレスポンス時間も確認
すぐに使える
インストール不要 — アカウントやプラグインなしでブラウザで完全動作
APIリクエストの送信方法
URLとメソッドを入力
APIエンドポイントURLを入力してHTTPメソッドを選択(GET、POSTなど)
ヘッダーとボディを追加
「ヘッダー」タブでAuthorization、Content-Typeなどを追加。POST/PUT用データには「ボディ」を使用。
送信して確認
「送信」をクリックしてリクエストを実行。レスポンスボディ、ステータスコード、時間が下に表示。
APIリクエストビルダーのユースケース
APIデバッグ
カスタムヘッダーとボディで個別エンドポイントをテストして認証・データの問題をデバッグ
認証トークンのテスト
コードを書かずにBearer、Basic Auth、APIキースキームをテスト
APIの探索
パブリックAPI(GitHub、OpenWeather、JSONPlaceholder)を探索してレスポンスを理解
バグの再現
バグレポート用の正確なリクエスト/レスポンスデータでAPIバグを再現・文書化
APIテストのベストプラクティス
✓ 必ずContent-Typeを設定
JSONボディを送信する際は常にContent-Type: application/jsonを含めてください。なしでは多くのAPIがリクエストを拒否または誤解釈します。
✓ CORSの制限を理解する
ブラウザは適切なCORSヘッダーなしにクロスオリジンリクエストをブロックします。ブラウザでリクエストが失敗する場合はcurlまたはサーバーサイドプロキシを使用してください。
✓ APIキーをハードコードしない
本番コードでは環境変数を使用してください。リクエストビルダーはテスト専用 — 実際のAPIキーがのったスクリーンショットは共有しないでください。
✓ HTTPステータスコードを確認
200=OK、201=Created、400=Bad Request、401=Unauthorized、403=Forbidden、404=Not Found、500=Server Error。
❓ よくある質問
なぜクロスオリジンリクエストが失敗するのですか?
ブラウザはCORS(Cross-Origin Resource Sharing)制限を適用します。ターゲットAPIにAccess-Control-Allow-Originヘッダーが含まれていない場合、ブラウザがリクエストをブロックします。これはエラーではありません — CORSサポートのないAPIにはcurlまたはバックエンドプロキシを使用してください。
multipart/form-dataリクエストを送信できますか?
現在のビルダーはJSONとプレーンテキストボディをサポートしています。ファイルアップロードなどのマルチパートフォームデータにはPostmanなどの専用ツールを使用してください。
これはPostmanの代替品ですか?
素早いテストと探索には代替品として使えます。チームコラボレーション、保存されたコレクション、環境、自動テストにはPostmanやBrunoがより多くの機能を提供します。
PUTとPATCHの違いは何ですか?
PUTはリクエストボディでリソース全体を置き換えます。PATCHは部分的な更新を適用します — ボディ内のフィールドのみが変更されます。ほとんどのREST APIは変更されていないフィールドを上書きしないようにPATCHを更新に使用します。