curlコマンドの使い方｜REST API（GET/POST/PUT/DELETE）とファイルダウンロード実践コマンド

# バージョンを確認する
$ curl --version
curl 7.81.0 (x86_64-pc-linux-gnu) libcurl/7.81.0 OpenSSL/3.0.2 zlib/1.2.11
Release-Date: 2022-01-05
Protocols: dict file ftp ftps gopher gophers http https ...

# Ubuntu / Debian / WSL2 の場合
sudo apt update && sudo apt install -y curl

# Rocky Linux / AlmaLinux / RHEL9 の場合
sudo dnf install -y curl

# Webページの内容を取得
curl https://example.com

# HTTPSの証明書エラーを無視する（テスト環境向け）
curl -k https://self-signed.example.com

# レスポンスヘッダだけ表示（HEAD リクエスト）
curl -I https://example.com

HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8
Content-Length: 1256
Server: nginx/1.24.0

# ヘッダ＋ボディの両方を表示
curl -i https://example.com

# ファイル名を指定して保存
curl -o localfile.tar.gz https://example.com/archive.tar.gz

# URLのファイル名でそのまま保存
curl -O https://example.com/archive.tar.gz

# ダウンロードの進捗を非表示にする（スクリプト向け）
curl -sO https://example.com/archive.tar.gz

# リダイレクト先まで追従して取得
curl -L https://example.com/old-page

# フォームデータを送信
curl -d "name=miyazaki&email=test@example.com" https://example.com/api/users

# JSONデータを送信
curl -X POST https://example.com/api/users   -H "Content-Type: application/json"   -d '{"name":"miyazaki","email":"test@example.com"}'

curl -X PUT https://example.com/api/users/1   -H "Content-Type: application/json"   -d '{"name":"updated_name"}'

curl -X DELETE https://example.com/api/users/1

# Authorizationヘッダを付与
curl -H "Authorization: Bearer your_token_here" https://example.com/api/data

# 複数のヘッダを指定
curl -H "Content-Type: application/json"      -H "Accept: application/json"      https://example.com/api/data

# ユーザー名:パスワードで認証
curl -u admin:password https://example.com/admin/

# パスワードを対話式で入力（コマンド履歴に残さない）
curl -u admin https://example.com/admin/

# 接続時間・転送時間・合計時間を計測
curl -o /dev/null -s -w "DNS: %{time_namelookup}s
Connect: %{time_connect}s
Total: %{time_total}s
" https://example.com

DNS: 0.012s
Connect: 0.045s
Total: 0.156s

# jqをインストールする（Ubuntu / Debian / WSL2の場合）
sudo apt install -y jq

# Rocky Linux / AlmaLinux / RHEL系の場合
sudo dnf install -y jq

# バージョン確認
jq --version
jq-1.6

# JSONレスポンスを整形表示
curl -s https://example.com/api/data | jq .

# 特定のフィールドだけ抽出
curl -s https://example.com/api/users | jq '.[].name'

# HTTPプロキシ経由でアクセス
curl -x http://proxy.example.com:8080 https://example.com

$ curl http://localhost:11434
Ollama is running

$ curl -s http://localhost:11434/api/tags | jq '.models[].name'
"llama3.2:latest"
"mistral:latest"

$ curl -s http://localhost:11434/api/generate   -d '{"model":"llama3.2","prompt":"Linuxのlsコマンドを一行で説明してください","stream":false}'
{
  "model": "llama3.2",
  "created_at": "2026-09-10T08:15:03.221Z",
  "response": "lsコマンドは、カレントディレクトリまたは指定したディレクトリの内容を表示するLinuxの基本コマンドです。",
  "done": true,
  "total_duration": 4521098000,
  "eval_count": 32
}

$ curl -s http://localhost:11434/api/generate   -d '{"model":"llama3.2","prompt":"Linuxのlsコマンドを一行で説明してください","stream":false}'   | jq -r '.response'
lsコマンドは、カレントディレクトリまたは指定したディレクトリの内容を表示するLinuxの基本コマンドです。

# APIキーを画面に表示せずに入力し、環境変数に設定する（ターミナルを閉じると消える）
read -rsp 'APIキー: ' OPENAI_API_KEY && echo && export OPENAI_API_KEY

# 永続化する場合は、自分だけが読める専用ファイル（権限600）に保存する
mkdir -p ~/.config/openai
touch ~/.config/openai/env
chmod 600 ~/.config/openai/env
printf 'export OPENAI_API_KEY="%s"
' "$OPENAI_API_KEY" > ~/.config/openai/env

# ~/.bashrc には読み込み設定だけを追記する（キー本体は書かない）
echo '[ -f ~/.config/openai/env ] && . ~/.config/openai/env' >> ~/.bashrc
source ~/.bashrc

# 設定確認（キーの値は表示せず、「設定済み」と表示されれば完了）
[ -n "$OPENAI_API_KEY" ] && echo 設定済み

curl -s https://api.openai.com/v1/chat/completions   -H "Content-Type: application/json"   -H "Authorization: Bearer $OPENAI_API_KEY"   -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "Linuxのlsコマンドの基本的な使い方を教えてください。"}
    ]
  }'

{
  "id": "chatcmpl-BvXrQw7M2kL9nPjF3eH5sT1",
  "object": "chat.completion",
  "created": 1756403127,
  "model": "gpt-4o-mini-2024-07-18",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "lsコマンドはディレクトリの内容（ファイルやサブディレクトリの一覧）を表示する基本コマンドです。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 38,
    "completion_tokens": 26,
    "total_tokens": 64
  }
}

curl -s https://api.openai.com/v1/chat/completions   -H "Content-Type: application/json"   -H "Authorization: Bearer $OPENAI_API_KEY"   -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "Linuxのlsコマンドの基本的な使い方を教えてください。"}
    ]
  }' | jq -r '.choices[0].message.content'

# ~/bin/ask スクリプトを作成する
mkdir -p ~/bin
cat > ~/bin/ask << 'SCRIPT'
#!/bin/bash
QUESTION="${1}"
if [ -z "$QUESTION" ]; then
  echo '使い方: ask "質問内容"' >&2
  exit 1
fi
# 質問文はjqでJSONに組み立て、パイプ経由でcurlに渡す
jq -nc --arg q "$QUESTION"   '{model: "gpt-4o-mini", messages: [{role: "user", content: $q}]}'   | curl -s https://api.openai.com/v1/chat/completions       -H "Content-Type: application/json"       -H "Authorization: Bearer $OPENAI_API_KEY"       -d @-   | jq -r '.choices[0].message.content'
SCRIPT

# 実行権限を付与してPATHを通す
chmod +x ~/bin/ask
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 呼び出し例
ask "Linuxでファイルの行数を数えるコマンドは？"

# テスト環境で証明書エラーを無視する場合
curl -k https://self-signed.example.com

# CA証明書を指定する場合
curl --cacert /path/to/ca-cert.pem https://example.com

# ネットワーク疎通を確認
ping example.com

# ポートが開いているか確認
ss -tlnp | grep :443

# DNS解決を確認
dig example.com

# 接続タイムアウトを10秒に設定
curl --connect-timeout 10 https://example.com

# リクエスト全体のタイムアウトを30秒に設定
curl -m 30 https://example.com

# Ubuntu / Debian / WSL2 の場合
sudo apt update && sudo apt install -y curl

# Rocky Linux / AlmaLinux / RHEL9 の場合
sudo dnf install -y curl

{
  "error": {
    "message": "Incorrect API key provided: sk-proj-**.",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}