curlコマンドとは？Web APIのテストやHTTP・JSON通信の実践例

curlコマンドとは？

curl（カール）は、コマンドライン（ターミナル）からさまざまなプロトコル（主にHTTPやHTTPS）を使ってURLとデータの送受信を行うためのツールです。「Client URL」に由来しており、ブラウザを開かなくてもWebページの内容を取得したり、サーバーにデータを送信したりすることができます。

主な役割とメリット

Webアプリケーション（特にREST API）の開発において、自分が作ったAPIが正しく動作するかどうかを手軽にテストする「デバッグツール」として最強の威力を発揮します。

どのような場面で使われるか

シェルスクリプトの中から外部のAPIを叩いてデータを取ってきたり、障害時にWebサーバーがどんなHTTPステータスコード（200 OK や 500 Errorなど）を返しているかヘッダーだけを確認する際に利用されます。

実務でよく使うオプションとAPIテスト

単純なGETリクエスト: curl https://example.com/api/users
POSTリクエストでJSONを送信する: REST APIにデータを新規登録する際に非常によく使う構文です。 curl -X POST -H "Content-Type: application/json" -d '{"name":"Taro", "age":25}' https://example.com/api/users
- -X POST: HTTPメソッドをPOSTに指定
- -H: HTTPヘッダーを指定（今回は中身がJSONであることを通知）
- -d: 送信するデータ本体（ペイロード）を指定
HTTPヘッダー情報の確認 (-I): curl -I https://example.com ページ本体（HTML文書）は取得せず、サーバーの種類（Nginxなど）やステータスコードだけを素早く確認します。
アクセス結果をファイルに保存 (-o, -O): curl -O https://example.com/file.zip （wgetコマンドの代わりとして使われます）

実務上の注意点

curlの結果で返ってくるJSONは通常1行で出力されるため、人間には非常に読みづらいです。実務では jq というコマンドと組み合わせて、curl https://api.example.com | jq のように実行し、JSONをきれいに整形（フォーマット）して表示するのが定石です。

よくあるエラーやトラブルシュート

Connection refused: サーバーが落ちているか、指定したポート（例: 8080）でWebサーバーのアプリケーションが起動していない場合に発生します。
証明書エラー（SSL certificate problem）: オレオレ証明書など、信頼できないSSL証明書を使っているAPIを叩くとはじかれます。-k（または --insecure）オプションをつけることでエラーを無視して接続を強行できます（テスト用途のみ）。