cURLコマンドジェネレーター＆ビルダー

curlコマンドとは何ですか？

# Plain GET — curl defaults to GET
curl https://api.example.com/users

# GET with a Bearer token (auth is just a header)
curl https://api.example.com/me \
  -H 'Authorization: Bearer YOUR_TOKEN'

# POST a JSON body — note the Content-Type header
curl -X POST https://api.example.com/users \
  -H 'Content-Type: application/json' \
  -d '{"name":"Ada","role":"admin"}'

# Multipart file upload — '@' reads the file from disk
curl -X POST https://api.example.com/upload \
  -F 'file=@report.pdf' \
  -F 'title=Q3 report'

主な機能

curlの代替ツールとHTTPクライアント

curlコマンドの例

curl https://api.example.com/users

curl https://api.example.com/me \
  -H 'Authorization: Bearer YOUR_TOKEN'

curl -X POST https://api.example.com/users \
  -H 'Content-Type: application/json' \
  -d '{"name":"Ada","role":"admin"}'

curl -X POST https://api.example.com/login \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'username=ada&password=s3cret'

curl -X POST https://api.example.com/upload \
  -F 'file=@report.pdf' \
  -F 'title=Q3 report'

curl -L -o archive.zip \
  https://example.com/files/archive.zip

curl -u ada:s3cret \
  https://api.example.com/private

curl -v -i https://api.example.com/health

curlコマンドの作成方法

1. 1

   HTTPメソッドを選択する

   GET・POST・PUT・PATCH・DELETE・HEAD・OPTIONSを選択します。curlはデフォルトでGETになります。POSTや他の動詞を選択すると、生成されたコマンドに`-X METHOD`が追加されます。またはプリセットチップをタップしてメソッドと対応するボディをワンクリックで設定できます。

2. 2

   URLとクエリパラメーターを入力する

   リクエストURL（例：`https://api.example.com/users`）を入力します。クエリパラメーターをキー・バリューペアで追加すると、ツールがURLエンコードして`?key=value&…`をURLに自動付加します — 手動エンコードは不要です。

3. 3

   ヘッダーと認証を追加する

   リクエストヘッダーをキー・バリューペアで追加し、認証スキームを選択します：なし・Bearerトークン・Basic（ユーザー名/パスワード）・カスタムAPIキーヘッダー。正しい`Authorization`またはカスタムヘッダーがサーバーの期待する正確な形式で生成されます。

4. 4

   リクエストボディを設定する

   POST・PUT・PATCHでは、ボディタイプを選択します：生のJSONを貼り付ける（`Content-Type`ヘッダーが自動追加）・URLエンコードされたフォームフィールドを作成・マルチパートアップロードを組み立てて`@`プレフィックスで任意のフィールドをファイルに切り替え。

5. 5

   オプションを切り替える

   必要なフラグを有効にします — リダイレクト追跡（`-L`）・安全でないTLS（`-k`）・詳細モード（`-v`）・ヘッダー表示（`-i`）・圧縮（`--compressed`）・ファイル出力（`-o`）・接続タイムアウト・プロキシ（`-x`）。各切り替えはコマンドをリアルタイムで更新します。

6. 6

   コピー・エクスポート・リセット

   完成したコマンドをコピーするか、「Export .sh」でスクリプトとしてダウンロードするか、「リセット」でフォームをクリアします。コピー前にマルチライン切り替えを使って1行形式とバックスラッシュ継続出力を切り替えてください。

curlのよくある間違い

# Intended a PATCH, but -d alone implies POST
curl -d '{"role":"admin"}' \
  https://api.example.com/users/7

# Set the verb explicitly
curl -X PATCH -d '{"role":"admin"}' \
  -H 'Content-Type: application/json' \
  https://api.example.com/users/7

# Server sees urlencoded, not JSON — 400/415
curl -X POST https://api.example.com/users \
  -d '{"name":"Ada"}'

# Declare the JSON content type
curl -X POST https://api.example.com/users \
  -H 'Content-Type: application/json' \
  -d '{"name":"Ada"}'

# $name gets expanded by the shell to empty string
curl -d "{\"user\":\"$name\"}" \
  https://api.example.com/users

# Single quotes send the body literally
curl -d '{"user":"$name"}' \
  https://api.example.com/users

# -d makes this a POST, not a GET
curl -d 'page=2&limit=50' \
  https://api.example.com/users

# Query string on the URL keeps it a GET
curl 'https://api.example.com/users?page=2&limit=50'

:: cmd.exe — backslash is not a continuation char
curl -X POST https://api.example.com/users \
  -d '{"name":"Ada"}'

:: cmd.exe — one line, or use ^ to continue
curl -X POST https://api.example.com/users -d "{\"name\":\"Ada\"}"

# Space splits the argument — curl sees two args
curl https://api.example.com/search?q=hello world

# Encode the space (or quote the whole URL)
curl 'https://api.example.com/search?q=hello%20world'

一般的なユースケース

REST APIテスト

ターミナルを離れずにRESTエンドポイントに対してリクエストを作成・実行します：メソッドを設定し、Bearerトークンを貼り付け、JSONボディを送信し、レスポンスを読みます。クライアントコードを書く前にAPIの動作を確認する最速の方法。

ドキュメントからのリクエスト再現

APIドキュメントにはエンドポイントとパラメーターが示されていますが、完全ですぐに実行できるコマンドはほとんどありません。ここでメソッド・URL・ヘッダー・認証を入力すると、そのまま実行できるcurlコマンドが得られます — クォートや`Content-Type`ヘッダーの欠落に悩む必要はありません。

CI/CDスモークテストスクリプト

ヘルスチェックやデプロイ後スモークテスト用のcurlコマンドを生成し、「Export .sh」でパイプラインに組み込みます。`--connect-timeout`と`--max-time`を追加して応答のないエンドポイントがビルドをブロックするのを防ぎ、`-w`でステータスコードを確認します。

ファイルアップロードとダウンロード

`-F field=@file`を使った`multipart/form-data`アップロードを組み立てるか、CDNへのリダイレクトを追跡する`-L -o filename`ダウンロードを構築します。トリッキーなファイル名やクエリ値は先にURLエンコーダーでエンコードしてください。

Webhookデバッグ

プロバイダーが送信するのと同じJSONボディを、正しいシグネチャと`Content-Type`ヘッダーとともにPOSTしてWebhookペイロードを再生します。ハンドラーが拒否した理由をデバッグするためにまったく同じリクエストをローカルで再現します。

再現可能なバグレポート

バグレポートやPRに、誰でも正確なリクエストを再現できる1つの完結したcurlコマンドを貼り付けます — メソッド・ヘッダー・認証プレースホルダー・ボディ。リクエストを文章で説明するよりはるかに明確です。

curlフラグを学ぶ

各フォームの選択が実際のフラグにどのようにマッピングされるかを確認します — Basic認証を選択すると`-u`が表示され、JSONボディを追加すると`Content-Type`ヘッダーが付加されます。curlチートシートと組み合わせた構文を学ぶ実践的な方法。

コードに変換するリクエストの準備

まずcurlとしてリクエストを構築・検証し、アプリのHTTPクライアントに変換します。近日公開予定のConvertタブが貼り付けたcurlコマンドをfetch・requests・Go・PHP・Ruby・Node.jsに変換します — 動作することが分かったcurlコマンドから始めましょう。

curlフラグと構文リファレンス

シェルクォートとエスケープ

ツールはシングルクォートで値を囲みます。POSIXシェルでシングルクォートされた文字列の内部は何も展開されないため、最も安全な形式です。値内のリテラルシングルクォートは`'\''`シーケンス（クォートを閉じ、エスケープされたクォート、クォートを再開）として出力されます。`cmd.exe`ではダブルクォートに切り替えてください。Git BashとWSLは生成されたシングルクォートコマンドをそのまま実行できます。

-d vs --data-raw vs --data-binary

`-d`/`--data`はボディから改行とキャリッジリターンを除去します — `key=value`ペアには問題ありませんが、複数行コンテンツには損失が生じます。`--data-raw`は同じですが先頭の`@`をファイル名として扱いません。`--data-binary`はバイトをそのまま送信します（ファイルの生の内容をアップロードするには`@file`を使用）。3つともメソッドが上書きされない限りPOSTを意味します。

マルチパート（-F）vs URLエンコード（-d）

`-F field=value`は生成された境界を持つ`multipart/form-data`を生成します — ファイルアップロード（`-F file=@path`）とファイル・テキスト混合フォームに必要です。`-d field=value`は`application/x-www-form-urlencoded`、`&`で結合した単一文字列を生成します。マルチパートでは`Content-Type`を手動設定しないでください。curlが境界を計算してヘッダーを自動設定します。

認証ヘッダーエンコード

Bearer認証は`Authorization: Bearer `をそのまま送信します（RFC 6750）。`-u user:pass`からのBasic認証は`Authorization: Basic `としてBase64エンコードされます — エンコードであって暗号化ではないため、HTTPSを使用してください。APIキーはサービスが要求するカスタムヘッダーです（例：`X-API-Key: `）。

クエリ文字列エンコード

ビルダーで追加されたクエリパラメーターはパーセントエンコードされて`?key=value&key2=value2`として付加されます。予約文字（スペース・`&`・`=`・`#`）はエスケープされてURLが有効になります。エンコードが必要なボディフィールドには、curlの`--data-urlencode`がリクエスト時にエンコードを処理します。

リダイレクトの動作（-L）

`-L`なしでは、curlは301/302レスポンスを表示して停止します。`-L`があると`Location`ヘッダーを追跡して最終URLに到達します。リダイレクトが別のホストをまたぐ場合、curlはセキュリティのデフォルトとして`Authorization`ヘッダーを削除することに注意してください。`--location-trusted`は影響を理解している場合にのみ使用してください。

圧縮レスポンス

`--compressed`はgzip/deflate/brotliサポートをアドバタイズする`Accept-Encoding`ヘッダーを追加し、レスポンスを透過的に解凍して帯域幅を節約します。デコードされたボディは非圧縮リクエストと同一です — 純粋な転送最適化であり、ほとんどのAPI呼び出しで安全に有効化できます。

出力：-o vs -O

`-o filename`はレスポンスボディを指定したファイルに書き込みます。`-O`はURLパスのリモートファイル名の下に保存します。どちらも通常の標準出力ダンプを抑制します。`-L`と組み合わせてリダイレクトが解決されてから実際のアセットが書き込まれるようにしてください。

curlリクエストのベストプラクティス

共有コマンドにシークレットをハードコードしない

PRやチケットやチャットに貼り付けたcurlコマンドは他の人が読み、ツールによってインデックスされます。トークンとパスワードをプレースホルダー（`YOUR_TOKEN`）に置き換えるか、環境変数を参照してください（`-H "Authorization: Bearer $API_TOKEN"`）。長い認証情報の場合、curlは`-H @headerfile`でファイルからヘッダーを読み込むことができ、シークレットがシェル履歴に表示されません。

バイナリペイロードには--data-binary @fileを優先する

ボディがバイトが重要なファイル — 画像・署名済みペイロード・空白が重要なJSON — の場合は、`-d @file`ではなく`--data-binary @file`を使用してください。プレーンな`-d`は改行とキャリッジリターンを除去し、バイナリや複数行コンテンツを静かに破損させます。`--data-binary`はファイルをディスク上のまま送信します。

ヘッダー値をクォートする

`-H`値は常にクォートで囲んでください：`-H 'Content-Type: application/json'`。クォートなしでは、コロンの後のスペースが引数を分割し、curlが不正なヘッダーを受け取ります。シングルクォートはシェルが値内の`$`・`*`などの特殊文字を展開するのも防ぎます — このツールがデフォルトで出力する形式です。

帯域幅節約に--compressedを使用する

API呼び出しやダウンロードに`--compressed`を追加してgzip/brotliエンコードをリクエストし、curlに透過的に解凍させます。JSONヘビーなAPIではこれで転送サイズを70〜90%削減でき、見るレスポンスは変わりません — エンドポイントを繰り返しポーリングするスクリプトにおける無料のメリットです。

スクリプトではタイムアウトを設定する

自動化されたコンテキストでは、遅いまたは応答のないエンドポイントがパイプラインを永遠にブロックしないよう`--connect-timeout`と`--max-time`を追加してください。`--max-time 10`のヘルスチェックは素早く失敗してCIを次に進めます。一時的なネットワーク障害を即座に諦めずに吸収するには`--retry N`と組み合わせてください。

自動化の前に-vで検証する

curlコマンドをスクリプトやcronジョブに組み込む前に、`-v`で一度実行して正確なリクエスト行・ヘッダー・TLSハンドシェイクを確認してください。誤ったメソッド・`Content-Type`の欠落・付加されなかった認証ヘッダーを発見する最速の方法です — インタラクティブにデバッグしてから、本番用に`-v`を削除してください。

よくある質問