curlでJSONをPOSTする方法【Linux、Windows対応】

Amazonのアソシエイトとして、IT技術ライフは適格販売により収入を得ています。

記事の文字数：1557

curlコマンドを使ってJSONデータをPOSTする方法を解説します。LinuxとWindowsそれぞれのコマンドを紹介します。基本的な使い方から外部ファイルの読み込み、HTTPヘッダーなどのレスポンス確認やエラー対処法まで、現場で活用できる情報を提供します。

2025/5/17 2025/5/17 更新

Web APIとのやりとりや、バックエンドとの通信確認など、開発現場で頻繁に使われるのがcurlコマンドです。特にJSON形式でデータを送信する機会は多く、フロントエンドからの動作確認、APIの疎通テスト、自動化スクリプトなど幅広い用途があります。

この記事では、curlを使ってJSONデータをPOSTする基本的な方法から、実践的な応用、トラブルシューティングまで、初心者にもわかりやすく解説します。

前提（JSONPlaceholderを利用）

JSONPlaceholderを利用して解説します。
- JSONPlaceholderは、無料のモックAPIサービスで、POST リクエストに対してダミーのレスポンスを返してくれます。
- 実際にAPI開発・デバッグで使われるcurlの動作を確認できます。

curlでPOSTする

まず、最もシンプルな形のcurlによるJSON POSTの例を見てみましょう。

コマンドプロンプトでcurlを実行

1
curl -X POST ^
2
  -H "Content-Type: application/json" ^
3
  -d "{\"title\":\"foo\",\"body\":\"bar\",\"userId\":1}" ^
4
  https://jsonplaceholder.typicode.com/posts

Linuxでcurlを実行

1
curl -X POST \
2
  -H "Content-Type: application/json" \
3
  -d '{"title":"foo","body":"bar","userId":1}' \
4
  https://jsonplaceholder.typicode.com/posts

1
{
2
  "title": "foo",
3
  "body": "bar",
4
  "userId": 1,
5
  "id": 101
6
}

OS/環境	指定方法の例
Linux	`-d '{"key":"value"}'` （シングルクォートOK）
Windows `cmd`	`-d "{\"key\":\"value\"}"` （ダブルクォート＆エスケープ）

各オプション（-X、-H、-d）の説明

-X POST: HTTPメソッドをPOSTに指定します。これはサーバー側にデータを送信したいときに必要です。
-H "Content-Type: application/json": リクエストヘッダに「このデータはJSON形式です」と明示するための指定です。
-d '{...}': 実際に送信するJSONデータ本体です。-dのあとにシングルクォートまたはダブルクォートで囲んだJSON文字列を記述します。

外部ファイルからJSONを読み込んでPOSTする

テストケースが複数ある場合や、JSONデータが長大でコマンドラインでの記述が煩雑になる場合は、外部ファイルからデータを読み込む方法が便利です。

まず、JSONデータをファイルに保存します。たとえば、data.jsonという名前のファイルに次のような内容を記述します。

1
{
2
    "name": "Alice",
3
    "age": 25,
4
    "city": "Tokyo"
5
}

その上で、以下のようにコマンドを実行します。

1
curl -X POST ^
2
  -H "Content-Type: application/json" ^
3
  -d @data.json ^
4
  https://jsonplaceholder.typicode.com/posts

1
curl -X POST \
2
  -H "Content-Type: application/json" \
3
  -d @data.json \
4
  https://jsonplaceholder.typicode.com/posts

-d @ファイル名の形式を使うことで、ファイル内の内容をそのままリクエストボディとして送信できます。

1
{
2
  "name": "Alice",
3
  "age": 25,
4
  "city": "Tokyo",
5
  "id": 101
6
}

HTTPヘッダーと詳細ログの表示

送信したリクエストに対して、サーバーがどのようなレスポンスを返してきたかを確認することも重要です。以下のオプションを活用することで、より詳細な情報を得ることができます。

1
curl -ivo response.txt -X POST ^
2
  -H "Content-Type: application/json" ^
3
  -d "{\"title\":\"foo\",\"body\":\"bar\",\"userId\":1}" ^
4
  https://jsonplaceholder.typicode.com/posts

1
curl -ivo response.txt -X POST \
2
  -H "Content-Type: application/json" \
3
  -d '{"title":"foo","body":"bar","userId":1}' \
4
  https://jsonplaceholder.typicode.com/posts