何をするツールですか?

cURLからコードへの変換ツールは、curlコマンドを、同じHTTPリクエストを自分のプログラムから送信するコードに変換します。次の3種類のコードを生成します。

  • JavaScript(fetch):ブラウザー、Deno、Bun、Node.jsに組み込まれているfetch API。
  • Node.js(Axios):広く使われているAxiosライブラリ。ファイルやTLS設定用のNode.jsモジュールも使用します。
  • Python(Requests):Requestsライブラリ。

コマンドを取得する一般的な方法は、ブラウザーの開発者ツールを使うことです。ネットワークパネルでリクエストを右クリックし、「cURLとしてコピー」を選択します。APIドキュメントでも、例としてcurlコマンドがよく使われています。

使い方

  1. curlコマンドを貼り付けます。長いコマンドは、各行の末尾にバックスラッシュを付けて複数行にできます。これはshellでの一般的な書き方です。
  2. 言語を選択します。
  3. コードをコピーするか、ファイルとしてダウンロードします(JavaScriptの場合はrequest.mjs、Pythonの場合はrequest.py)。

入力するとコードが更新されます。閉じていない引用符や不明なオプションなど、curl自体の実行を妨げる誤りがコマンドにある場合は、その箇所が表示されます。

変換される内容

  • メソッド。curlが自動的に選択するものも含みます。-dと-FはPOST、-IはHEAD、-TはPUTになります。
  • URL。-Gまたは--url-queryで追加されるクエリも含みます。
  • -Hで指定したヘッダー、-Aで指定したUser-Agent、-eで指定したリファラー、-bで指定したcookies。Pythonではcookiesの辞書になります。
  • -uまたはURLで指定したBasic認証。各ライブラリ独自の方法で送信します。また、--oauth2-bearerで指定したBearer tokenにも対応します。PythonではDigest認証も利用できます。
  • リクエストボディ:--jsonまたはJSON Content-Typeで指定したJSONはオブジェクトまたは辞書に、-dで指定したフォームデータはURLSearchParamsまたは辞書に、-Fで指定したマルチパートフォームはFormDataまたはfilesの辞書になります。ファイルのアップロードにも対応します。
  • --max-timeで指定したタイムアウト(Pythonでは--connect-timeoutも含む)、TLSチェックを省略する-k、CA証明書とクライアント証明書、-xで指定したプロキシ。

curlが自動で追加するヘッダー(独自のUser-Agent、Accept: */*、Content-Lengthなど)は、各ライブラリが独自に送信するため省略されます。-sや-vのように、curlのレスポンス表示方法だけを変更するオプションも省略されます。

変換できない場合

ライブラリや言語に相当する機能がないものもあります。その場合は、コードの先頭にコメントとして記載されるため、何も通知されずに省略されることはありません。

  • --retryなど、対応する機能がないオプションは「未変換」として記載されます。
  • fetchではTLSチェックの省略、プロキシの使用、接続タイムアウトの設定はできません。また、ブラウザーではスクリプトからCookieヘッダーを設定できませんが、Node.jsでは設定できます。
  • -d @data.jsonや-F photo=@cat.jpgのようにcurlが読み込むファイルは、Node.jsとPythonではディスクから読み込まれます。ブラウザーのJavaScriptでは置き換え用のプレースホルダーとして表示されます。たとえば、<input type="file">から取得したファイルに置き換えられます。
  • コマンドが複数のリクエストを送信する場合、コードは最初のリクエストを対象にします。

例

  • curl https://example.com/は、Pythonではrequests.get("https://example.com/")になります。
  • curl -u ada:secret https://api.example.com/meは、Pythonではauth=("ada", "secret")に、Axiosではauthオプションになります。
  • curl --json '{"item": "sourdough loaf"}' https://api.example.com/ordersは、Pythonではjson={"item": "sourdough loaf"}に、fetchではJSON.stringify({ item: "sourdough loaf" })になります。

仕組み

サイトのcURLコマンド検証ツールと同じパーサーを使い、引用符、エスケープ、行継続を含めて、shellとcurlがコマンドを読み取る方法に沿って解析します。その後、curlが送信するリクエストをコードとして出力します。すべてブラウザー内で処理されるため、tokenやパスワードを含むコマンドがデバイスの外に送信されることはありません。

機能

  • JavaScript fetch、Node.js Axios、Python Requestsに対応
  • ヘッダー、cookies、Basic認証、Bearer認証に対応
  • JSON、フォーム、マルチパート、ファイルのリクエストボディに対応
  • タイムアウト、TLSオプション、証明書、プロキシに対応
  • 変換できない内容をコメントで表示
  • コマンドの誤りをわかりやすく表示
  • コードのコピーまたはダウンロード
  • ブラウザー内で動作