cURL コマンドの読み方

cURL コマンドは HTTP リクエストであり、同時にシェルコマンドでもあります。変換する前に、この 2 つの層を分けてください。

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

HTTP リクエストには次が含まれます。

• メソッド: POST
• URL: https://api.example.com/users
• ヘッダー: Authorization、Content-Type
• ボディ: {"name":"Ada"}

シェル層には引用符、行継続、エスケープ規則が含まれます。

URL の位置

URL は末尾、先頭付近、または --url の後に現れることがあります。

curl --url "https://api.example.com/search?q=json"

コンバーターは、常に最後のトークンであると仮定せず、リクエスト URL を特定すべきです。

引用符が重要

シングルクォート、ダブルクォート、バックスラッシュは、cURL が引数を受け取る前にシェルによって解釈されます。ドキュメントからコピーしたコマンドは Bash、zsh、PowerShell、CMD 向けに書かれていることがあります。変換では、リテラルの引用符ではなく、意図された HTTP 値を保持すべきです。

ボディフラグはデフォルトを変える

cURL が -d を見ると、別のメソッドが指定されない限り、リクエストは多くの場合 POST になります。そのデフォルトは、GET を期待していた開発者を驚かせることがあります。

コマンドを 2 パスで読んでください。まずシェル構文として、次に HTTP リクエストとして。これらの層を混ぜないと、変換がより安全になります。