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）オプションをつけることでエラーを無視して接続を強行できます（テスト用途のみ）。

まとめ

curlコマンドを使いこなせるかどうかで、バックエンド開発やAPI連携時のデバッグスピードが劇的に変わります。PostmanなどのGUIツールも便利ですが、サーバー上でサッと確認できるcurlの構文（特にJSONのPOST方法）は暗記しておいて損はありません。