APIを実装・利用するとき、「まず一回叩いて動作を確認する」という作業が何度も発生します。メソッドやヘッダー、ボディを正しく組み立て、返ってきたステータスコードの意味を判断し、フロントエンドから呼ぶならCORSも設定する——この一連の流れは、慣れないうちは手戻りが多い部分です。この記事では、APIを叩いて動作確認するまでの手順を、リクエストの組み立てからコード化、レスポンスの判断、CORS設定まで、実際のツールとあわせて順番に紹介します。
1. リクエストをGUIで組み立てる
まずは叩きたいリクエストを組み立てます。メソッド（GET/POST/PUT/DELETE など）、URL、クエリパラメータ、ヘッダー（Authorization や Content-Type）、JSONボディを一つずつ指定していきます。HTTPリクエストビルダーを使うと、これらをGUIで入力しながらリクエストの全体像を確認でき、JSONボディの構文もその場でチェックできます。手書きでcurlを組むとクォートのエスケープやヘッダーの綴りでつまずきがちですが、GUIで組み立てると入力漏れやスペルミスを防げます。まずは「どんなリクエストを送るか」をここで固めます。
この手順で使うツール
HTTP Request Builder
GUIでHTTPリクエストを組み立て curl / fetch / axios コードを即生成
2. curl / fetch / axios のコードに変換する
組み立てたリクエストは、そのままコードに落とし込めると便利です。cURL to Code を使うと、curlコマンドを Python requests・JavaScript fetch・axios・Shell wget などに変換できます。ターミナルで動作確認したcurlを、そのままアプリのコードに移植する——という流れがスムーズになります。逆に、ドキュメントに載っているcurlの例を貼り付けて、自分のプロジェクトで使う言語のコードに変換する使い方も便利です。メソッド・ヘッダー・ボディが各言語の書き方で正しく展開されるので、手で書き写す際のミスを避けられます。
この手順で使うツール
cURL to Code
cURL コマンドを fetch / axios / Python requests / HTTPie に変換
3. レスポンスのステータスコードを判断する
リクエストを送ったら、返ってきたステータスコードで結果を判断します。200番台なら成功ですが、201（作成）・204（本文なし）の違いや、400（リクエストが不正）と401（未認証）・403（権限なし）・404（存在しない）・409（競合）・422（内容が処理できない）の使い分けを正しく理解しておくと、エラーの原因を素早く切り分けられます。HTTPステータスリファレンスで番号やキーワードから意味を引き、「これはクライアント側の問題か、サーバー側の問題か」「認証の問題か、認可の問題か」を判断します。特に4xxはリクエストの組み立てを見直すヒントになります。
この手順で使うツール
HTTP Status Reference
HTTPステータスコードを番号/キーワードで検索 — 説明・用途・ヘッダー例を表示
4. ブラウザから叩けるようCORSを設定する
ターミナルやサーバー同士では動くのに、フロントエンドのJavaScriptから叩くとCORSエラーになる——これはよくあるつまずきです。CORSはブラウザの制限で、サーバーが返す Access-Control-* ヘッダーで「このオリジンからのアクセスを許可する」と伝える必要があります。CORSヘッダービルダーで、許可するオリジン・メソッド・ヘッダー・credentials を指定すると、正しいレスポンスヘッダーと nginx / Express / Next.js の設定スニペットを生成できます。「* と credentials の併用」など、ブラウザに拒否される典型的な誤設定はその場で警告されるので、本番で初めて気づく事故を防げます。PUT/DELETE やカスタムヘッダー付きのリクエストは事前にOPTIONS（プリフライト）が飛ぶため、OPTIONSにも同じヘッダーを返す設定を忘れないようにします。
この手順で使うツール
CORS Header Builder
CORSのAccess-ControlヘッダーをGUIで生成
まとめ
APIの動作確認は「リクエストを組み立てる → コードに変換する → ステータスコードで判断する → CORSを設定する」の流れで進めると、手戻りを減らせます。特にステータスコードの使い分けとCORSの設定は、原因が分かりにくくハマりやすいポイントなので、手順として押さえておくと安心です。まずGUIでリクエストを固め、コード化して実装に移し、返ってきたコードで判断し、ブラウザから呼ぶならCORSを整える——この順番を習慣にすると、API連携の動作確認がスムーズになります。