cURL コンバーター

cURL コンバーターとは？

cURLコンバーターは、APIドキュメント、Postmanのエクスポート、AIアシスタントの出力など、あらゆる場所で目にする curl コマンドを、あなたが実際に使うプログラミング言語のコードに変換するツールです。ヘッダー、クエリ文字列、JSONボディ、マルチパートアップロード、Basic認証、Cookieまでまるごと引き継がれるので、リクエストを手作業で書き直す必要はありません。

curl はHTTPリクエストを記述するうえでもっとも汎用的な方法ですが、本番環境で *実際に* curlを実行することはほとんどありません。実際に動くのはJavaScriptの fetch、Pythonの requests、Goの net/http など、あなたのスタックに合わせたコードです。このツールはその橋渡しをします - curlを貼り付け、タブを選び、コードをコピーするだけです。

すべての処理はブラウザ内でローカルに動きます。curlコマンド、ヘッダー、トークンが端末から外に出ることは一切ありません。実在するBearerトークンやセッションCookieを含むコマンドを貼り付けるときも安心です。

変換しながら身につくこと

• curlのフラグは、どのHTTPクライアントでも特定の概念に対応します。-H はリクエストヘッダー、-d はボディ、-X はメソッド、-u はBasic認証、-F はマルチパートのフォームフィールドです。
• curlがボディ（-d、--data、-F）を見つけて -X が指定されていない場合、自動的に POST が選ばれます。多くのクライアントも同じ既定なので、-X を省略しても出力は POST になります。
• JSONボディとフォームボディはまったくの別物です。Content-Type: application/json ならボディはそのまま送信され、application/x-www-form-urlencoded ならキーと値が & で連結されて送られます。
• -G を使うと、GET リクエストのボディがクエリ文字列に昇格します。出力にはそれが反映され、params / query が埋まり、ボディは送信されません。

curlからコードへ変換する手順

1. 1

   curlコマンドを貼り付ける

   ドキュメントからコピーした \ の行継続も含めて、コマンド全体を入力欄に貼り付けます。スマートクォートやPowerShellのプロンプト記号もパーサーが自動で正規化してくれます。

2. 2

   ターゲット言語を選ぶ

   JavaScript fetch、TypeScript、Node axios、Python requests、Python httpx、Go、PHP、Ruby、Java HttpClient、C# HttpClient、HTTPie、PowerShellのタブが用意されています。パース処理は一度しか走らないので、タブの切り替えはノーコストです。

3. 3

   パース結果を確認する

   *Parsed request* パネルを開いて、メソッド、URL、ヘッダー、ボディの種類、insecure や follow redirects といったオプションが意図どおり読み取られているかを確認します。

4. 4

   コピーして認証情報を調整する

   生成されたコードをプロジェクトに貼り付けます。curlにBearerトークンやCookieが含まれていた場合は、コミットする前にリテラル値を環境変数に置き換えましょう。

cURLフラグのクイックリファレンス

このコンバーターが認識するフラグと、生成コードで何にマッピングされるかの対応表です。

cURL変換の例

curl 'https://api.example.com/v1/lessons?limit=20&track=python' \  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.demo'

const response = await fetch('https://api.example.com/v1/lessons?limit=20&track=python', {  method: 'GET',  headers: {    'Authorization': 'Bearer eyJhbGciOiJIUzI1NiJ9.demo'  }});const data = await response.json();

curl 'https://api.example.com/v1/users' \  -H 'Content-Type: application/json' \  --data-raw '{"name":"Ada","age":36}'

import requests
headers = {    'Content-Type': 'application/json',}json_data = {"name":"Ada","age":36}
response = requests.post('https://api.example.com/v1/users', headers=headers, json=json_data)response.raise_for_status()

curl 'https://api.example.com/upload' \  -F 'caption=Hello' \  -F 'photo=@./avatar.jpg'

import requests
files = {    'caption': (None, 'Hello'),    'photo': open('./avatar.jpg', 'rb'),}
response = requests.post('https://api.example.com/upload', files=files)response.raise_for_status()

curl 'https://api.example.com/me' \  -u alice:s3cret \  -b 'session=2f9a; theme=dark'

const response = await fetch('https://api.example.com/me', {  method: 'GET',  headers: {    'Authorization': 'Basic YWxpY2U6czNjcmV0',    'Cookie': 'session=2f9a; theme=dark'  }});

curl変換でよくあるミス

• ブログ記事などからスマートクォート（'、'、"、"）付きでcurlを貼り付けてしまうこと。見た目はクォートですが、シェルのパースを壊します。コンバーターは正規化してくれますが、できれば元のコマンドをそのままコピーしましょう。
• 本番環境で -k（--insecure）を残したままにすること。これはTLS証明書の検証を無効化します。ローカル開発なら問題ありませんが、本番のトラフィックでは危険です。
• --data-raw と --data の挙動の違いを忘れてしまうこと。--data は入力をURLエンコードします。@ や & を含むJSONボディには --data-raw を使いましょう。
• Windowsの curl.exe のコマンドを、^ の行継続を \ に変換せずに貼り付けてしまうこと。コンバーター側で処理しますが、パーサーはクォートに厳格なので、文字列の境界はしっかり確認してください。
• 変換後のBearerトークンやCookieをそのままバージョン管理に入れてしまうこと。コミット前に環境変数（process.env.API_TOKEN、os.environ['API_TOKEN']）に置き換えましょう。

cURL コンバーターのFAQ