cURL → コード変換

使い方

`curl ...` コマンドを貼り付けてください。一行でも、バックスラッシュで継続した複数行でも、値が引用符に囲まれていても、API ドキュメントが渡してくるどんな形でも大丈夫です。パーサがメソッド、URL、ヘッダ、ボディ、認証に分解し、JavaScript fetch、axios、Python requests、Go `net/http` の同等コードを生成します。タブを切り替えて対象言語を選び、スニペットをコピーしてエディタに貼り付けてください。

API ドキュメントが curl の例を出し、自分のスタックが別言語のときに使ってください。ブラウザのネットワークリクエストをリバースエンジニアリングする際(Chrome / Firefox の DevTools で右クリック → cURL としてコピー)や、Postman / Insomnia でリクエストを書いて同等コードをコミットしたいときにも有効です。変換は一般的なオプション(`-X`、複数の `-H` ヘッダ、`-d` / `--data` / `--data-raw`、Basic 認証の `-u`、マルチパートの `--form`、`\` による行継続など)を扱いますが、出力が実際に動くかは必ず確認してください。各言語に独自のエスケープ規則があり、curl - コード変換は珍しいフラグの組み合わせの意図までは推測しきれません。

例

curl https://api.example.com/users/42 \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -H "Accept: application/json"

// fetch
await fetch("https://api.example.com/users/42", {
  headers: {
    "Authorization": "Bearer eyJhbGciOi...",
    "Accept": "application/json",
  },
});

# requests
requests.get(
  "https://api.example.com/users/42",
  headers={
    "Authorization": "Bearer eyJhbGciOi...",
    "Accept": "application/json",
  },
)

curl -X POST https://api.example.com/orders \
  -H "Content-Type: application/json" \
  -d '{"item_id": 42, "quantity": 2}'

// fetch
await fetch("https://api.example.com/orders", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ "item_id": 42, "quantity": 2 }),
});

# requests
requests.post(
  "https://api.example.com/orders",
  json={"item_id": 42, "quantity": 2},
)

curl -X POST https://api.example.com/upload \
  -u admin:secret \
  --form "[email protected]" \
  --form "caption=hello"

// fetch
const form = new FormData();
form.append("file", fileInput.files[0]);
form.append("caption", "hello");
await fetch("https://api.example.com/upload", {
  method: "POST",
  headers: { "Authorization": "Basic " + btoa("admin:secret") },
  body: form,
});

# requests
requests.post(
  "https://api.example.com/upload",
  auth=("admin", "secret"),
  files={"file": open("photo.jpg", "rb")},
  data={"caption": "hello"},
)

よくある質問

関連する概念

curl(1997 年、Daniel Stenberg 作)は HTTP の共通言語です。あらゆる Linux ディストリ、macOS、Windows 10 以降、Docker のベースイメージ、CI ランナーに同梱されるコマンドラインクライアントです。その構文はドキュメントを兼ねます。任意の HTTP リクエストは一行の curl で表せるため、Stripe・GitHub・Twilio・AWS など、ほとんどの API ドキュメントは内部の SDK が何であれ curl 例を載せています。curl からの変換は、ドキュメントのネイティブ形式から自分のスタックの形式への変換に等しいのです。

パースは見た目より厄介です。シェルのトークン化(引用符・エスケープ・バックスラッシュ行継続・`$variable` 展開)は curl に届く前に行われるため、堅牢なパーサは POSIX シェルを十分に模倣して入力を正しく分割する必要があります。次に、各フラグに固有の意味があります。`-d` はメソッドを POST に切り替え Content-Type を設定する、`-G` はそれを反転して GET + クエリパラメータにする、`-H` は反復可能、`-u user:pass` は Basic 認証ヘッダを生成する、`--data-urlencode key=value` は値を送信前に URL エンコードする、といった具合です。本格的なコンバータは `man curl` から取ったフラグ表を保持しますが、本ツールは実環境の curl コマンドの 99% に登場する 30 余りのフラグをカバーします。

隣接する 3 概念があります。**OpenAPI / Swagger** は、同じリクエストをコードジェネレータが多数の言語でクライアントを生成できるくらい抽象的に記述します。一回限りの curl - コード問題に対する体系的な解です。**HAR(HTTP Archive)** は DevTools の「全部を HAR で保存」で書き出される JSON 形式で、ヘッダもボディも含めたリクエスト / 応答全体を保持し、`har2curl` などで curl やコードに変換できます。**Postman / Insomnia / Bruno** は同じワークフローの GUI 版で、curl を貼り付けると編集可能なリクエストになり、複数言語へエクスポートできます。本コンバータは、curl とエディタ上のコードを直結する最も素朴な形に位置します。