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

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
}

各オプション（-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

各オプション（-i、-v、-o）の説明

• -i: HTTPヘッダー情報を表示。
• -v: 詳細な通信ログを表示。トラブル発生時のデバッグに有効。
• -o response.txt: レスポンス内容をファイルに保存。

curlのトラブルシューティング

curlを使っていると、意図しないエラーに遭遇することがあります。以下に代表的なエラーとその原因、対処法をまとめます。

HTTP/1.1 500 Internal Server Error

• 原因: JSONの構文エラー（例: クォートの不一致、カンマ忘れ）
• 対処: JSONをバリデーションツールなどで検証しましょう。

Linuxユーザにお勧めの本

新しいLinuxの教科書　第２版

ゼロからわかる　Linuxコマンド200本ノック―基礎知識と頻出コマンドを無理なく記憶に焼きつけよう！

エンジニア1年生のための世界一わかりやすいLinuxコマンドの教科書