cURLからPowerShellへ

curlコマンドを貼り付けると、Invoke-RestMethodを使うPowerShellスクリプトが得られます。引用符の扱いでAPIトークンが欠けることもありません。

変換はすべてブラウザ内で行われます。トークンや資格情報を含むコマンドが端末の外へ出ることはありません。

開発・運営:Udit Agarwal

curlをC#に変換する

cURLからPowerShellへ について

curlコマンドをそのままPowerShellに貼り付けても、まず動きません。フラグが違うからだけではありません。PowerShellはダブルクォートの文字列の中で変数を展開するため、ドル記号を含むトークンは黙って空文字列になり、リクエストは理由もわからないまま401で返ってきます。この変換ツールは全体をシングルクォートのリテラルで出力します。PowerShellはこれを生のテキストとして扱い、内部の引用符は二重にしてエスケープします。ヘッダーはハッシュテーブルに、JSONボディはConvertTo-Jsonにパイプするハッシュテーブルになるので、送信前に編集できます。Basic認証はBase64のAuthorizationヘッダーとして組み直します。PowerShellではそうするしかないからです。結果はWindows PowerShellでも、各プラットフォームのPowerShell 7でもそのまま動きます。

機能

  • パラメーターを読みやすく行分けしたInvoke-RestMethod
  • ヘッダーをPowerShellのハッシュテーブルとして出力
  • JSONボディはConvertTo-Jsonにパイプするハッシュテーブルとして出力
  • シングルクォートのリテラルなので、トークン内の$が展開されない
  • Basic認証はBase64のAuthorizationヘッダーとして組み直し
  • Content-Typeは-ContentTypeパラメーターで指定
  • PowerShellに対応するものがないcurlのフラグを警告
  • 結果を.ps1ファイルとしてダウンロード
  • 変換はすべてブラウザ内で完結

cURLからPowerShellへ の使い方

  1. APIドキュメントからcurlコマンドをコピーします
  2. 左側の欄に貼り付けます
  3. 右側に生成されたPowerShellのコードを確認します
  4. コピーするか、.ps1ファイルとしてダウンロードします

例

入力

curl https://api.example.com/users -H "X-Api-Key: abc123"

出力

$headers = @{
    'X-Api-Key' = 'abc123'
}

$response = Invoke-RestMethod `
    -Uri 'https://api.example.com/users' `
    -Method GET `
    -Headers $headers

シングルクォートなら、キーにどんな文字が含まれていても値はそのまま扱われます。

よくあるエラーとトラブルシューティング

  • トークンは正しいのに、リクエストが401を返す。 — PowerShellのダブルクォート文字列はドル記号以降を変数として展開するため、トークンの一部が消えてしまいます。この変換ツールが出力するシングルクォートのままにするか、ドル記号をバッククォートでエスケープしてください。
  • JSONボディがサーバーに崩れた形や違う型で届く。 — ConvertTo-Jsonの-Depthを確認してください。既定値は2で、それより深い入れ子のオブジェクトは黙って型名に置き換えられます。生成されるコードが10を指定しているのはまさにそのためです。
  • ボディに含まれるASCII以外の文字が文字化けする。 — Windows PowerShell 5.1は、ボディに既定でUTF-8以外のエンコーディングを使います。PowerShell 7に移行するか、JSONをUTF-8のバイト列に変換してボディとして渡してください。

よくある質問

PowerShellのcurlはInvoke-WebRequestと同じものですか。
Windows PowerShell 5.1では、curlはInvoke-WebRequestのエイリアスです。本物のcurlコマンドを貼り付けると紛らわしいパラメーターエラーで失敗するのはそのためです。PowerShell 7ではこのエイリアスが廃止されたので、インストールされていればcurlは本物のcurlを指します。
Invoke-RestMethodとInvoke-WebRequestのどちらを使うべきですか。
APIならInvoke-RestMethodです。JSONの応答を、そのまま扱えるオブジェクトに解析してくれます。Invoke-WebRequestはステータスコードやヘッダーを含む生の応答を返すので、それらの詳細が重要なときに使います。
PowerShellでBasic認証を送るには。
username:passwordをBase64でエンコードし、Authorizationヘッダーとして渡します。-Credentialパラメーターもありますが、サーバーからチャレンジを受けた後にしか資格情報を送らず、多くのAPIはそのチャレンジを返しません。
パラメーターがバッククォートで行分けされているのはなぜですか。
バッククォートはPowerShellの行継続文字なので、長い呼び出しを複数行にわたって読みやすく保てます。ただし行の最後の文字でなければならず、後ろに空白があってはいけないので、手で編集すると壊しやすい点に注意してください。
生成されたPowerShellスクリプトはLinuxやmacOSでも動きますか。
動きます。クロスプラットフォームのPowerShell 7で実行してください。コマンドレット、ハッシュテーブルの構文、ConvertTo-Jsonは、どれもWindowsと同じように動作します。

関連ツール

API ツールの他のツール

  • cURLからSwiftへ — curlコマンドをURLSessionのSwiftコードに変換。
  • cURLからDartへ — curlコマンドをpackage:httpのDartコードに変換。
  • cURL から Fetch — curlコマンドを JavaScript の fetch() 呼び出しに変換します。
  • URL パーサー — URLを各パーツに分解し、クエリパラメータを一覧表示します。
  • API クライアント — HTTPリクエストを送信し、ヘッダーやパラメータを作成して応答を確認。直近25件を保存します。
  • URLビルダー&UTMジェネレーター — UTMパラメータを使用して完全にエンコードされた本番用URLを構築および検証します。
  • OpenAI API テスター — OpenAI Chat Completions API のリクエストを作成・実行し、cURL、Python、JavaScript としてコピーします。
  • Anthropic Claude API テスター — Anthropic Claude Messages API のリクエストを作成・実行し、cURL、Python、JavaScript としてコピーします。
  • Google Gemini API テスター — Google Gemini の generateContent API リクエストを作成・実行し、cURL、Python、JavaScript としてコピーします。
  • Replicate API テスター — Replicate の予測 API リクエストを作成・実行し、cURL、Python、JavaScript としてコピーします。
  • Hugging Face API テスター — Hugging Face Inference API のリクエストを作成・実行し、cURL、Python、JavaScript としてコピーします。
  • curl to Python 変換ツール — curlコマンドをPythonのrequestsコードに変換します。

API ツールのツールをすべて見る (24) · すべてのツール