# 最简单的 GET 请求（输出到 stdout）
curl https://httpbin.org/get

# 带有查询参数的 GET 请求
curl "https://httpbin.org/get?name=curl&version=8"

# 使用 --data-urlencode 自动编码参数
curl -G https://httpbin.org/get \
  --data-urlencode "name=张三" \
  --data-urlencode "city=北京"

# 等价于：
# curl "https://httpbin.org/get?name=%E5%BC%A0%E4%B8%89&city=%E5%8C%97%E4%BA%AC"

# 使用 -o 指定文件名
curl -o output.html https://example.com

# 使用 -O 使用远程文件名
curl -O https://example.com/document.pdf

# 使用 -o 保存到指定目录
curl -o /tmp/page.html https://example.com

# 静默模式 + 保存文件（适合脚本）
curl -s -o /dev/null https://example.com

# 默认行为：输出到 stdout
curl https://example.com

# 静默模式：不显示进度条和错误信息
curl -s https://example.com

# 仅显示错误（适合脚本中使用）
curl -S https://example.com

# 静默但显示错误
curl -sS https://example.com

# 不输出响应体（仅获取头信息）
curl -I https://example.com

# 同时输出响应头和响应体
curl -i https://example.com

# 详细模式（显示请求/响应细节）
curl -v https://example.com

# 发送 POST 请求（application/x-www-form-urlencoded）
curl -X POST https://httpbin.org/post \
  -d "name=curl&version=8"

# 等价于（-X POST 可省略，-d 自动设置 POST 方法）
curl https://httpbin.org/post \
  -d "name=curl&version=8"

# 发送 JSON POST
curl -X POST https://httpbin.org/post \
  -H "Content-Type: application/json" \
  -d '{"name": "curl", "version": 8}'

# 从文件读取 POST 数据
curl -X POST https://httpbin.org/post \
  -H "Content-Type: application/json" \
  -d @data.json

# 从 stdin 读取 POST 数据
echo '{"key": "value"}' | curl -X POST https://httpbin.org/post \
  -H "Content-Type: application/json" \
  -d @-

# 使用 --data-raw 发送原始数据（不处理 @ 前缀）
curl https://httpbin.org/post \
  --data-raw '{"key": "@value"}'

# 使用 --data-binary 发送二进制数据
curl https://httpbin.org/post \
  --data-binary @image.png

# 使用 --data-urlencode 发送 URL 编码数据
curl https://httpbin.org/post \
  --data-urlencode "comment=Hello World&Goodbye"

# 设置单个请求头
curl -H "User-Agent: MyApp/1.0" https://example.com

# 设置多个请求头
curl -H "User-Agent: MyApp/1.0" \
     -H "Accept: application/json" \
     -H "X-Request-ID: abc123" \
     https://api.example.com/data

# 移除默认请求头（使用分号后无值）
curl -H "User-Agent:" https://example.com

# 设置 Cookie
curl -H "Cookie: session=abc123; user=张三" https://example.com

# 使用 -b 设置 Cookie
curl -b "session=abc123" https://example.com

# 使用 Cookie 文件
curl -b cookies.txt https://example.com

# 仅查看响应头
curl -I https://example.com

# 查看响应头和响应体
curl -i https://example.com

# 详细模式查看所有头信息
curl -v https://example.com 2>&1 | grep "^[<>]"

# 提取特定响应头
curl -sI https://example.com | grep -i "content-type"

# 原始输出（默认）
curl https://httpbin.org/get

# 美化 JSON 输出（需要 jq）
curl -s https://httpbin.org/get | jq .

# 仅提取特定字段
curl -s https://httpbin.org/get | jq '.headers["User-Agent"]'

# 输出为 HTML 格式（在终端中显示）
curl -s https://example.com | lynx -stdin

# 输出到多个文件
curl -o header.txt -D - https://example.com > body.txt

# 使用 -D 将响应头保存到文件
curl -D response_headers.txt https://example.com

# 使用 -D 将响应头输出到 stdout
curl -D - https://example.com

# 结合 -o 和 -D 分别保存响应体和响应头
curl -o body.html -D headers.txt https://example.com

# 显示进度条（默认，当输出到终端时）
curl -O https://example.com/largefile.zip

# 显示简化的进度条
curl -# -O https://example.com/largefile.zip

# 静默模式（不显示进度条）
curl -s -O https://example.com/largefile.zip

# 强制显示进度条（即使输出被重定向）
curl -O https://example.com/largefile.zip --progress-bar

# 手动编码 URL
curl "https://httpbin.org/get?name=%E5%BC%A0%E4%B8%89"

# 使用 --data-urlencode 自动编码
curl -G https://httpbin.org/get \
  --data-urlencode "name=张三"

# 多个参数
curl -G https://httpbin.org/get \
  --data-urlencode "name=张三" \
  --data-urlencode "city=北京" \
  --data-urlencode "message=Hello World"

# 使用 {} 展开多个 URL
curl "https://httpbin.org/{get,post,put}"

# 使用 [] 生成数字序列
curl "https://httpbin.org/get?page=[1-5]"

# 使用 [] 生成字母序列
curl "https://httpbin.org/get?file=[a-c].txt"

# 组合使用
curl "https://httpbin.org/get?id=[1-3]&type=[a,b,c]"

# 跟随重定向
curl -L https://example.com

# 限制重定向次数
curl -L --max-redirs 5 https://example.com

# 使用代理
curl -x http://proxy.example.com:8080 https://example.com

# 使用 SOCKS 代理
curl --socks5 127.0.0.1:1080 https://example.com

# 完整的 API 调试命令
curl -v -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"name": "张三", "email": "zhangsan@example.com"}' \
  -w "\n\n--- 调试信息 ---\nHTTP 状态码: %{http_code}\n响应时间: %{time_total}s\n大小: %{size_download} bytes\n"

# 下载多个文件
for i in $(seq 1 10); do
  curl -s -O "https://example.com/files/file${i}.txt"
done

# 检查服务健康状态
if curl -sf http://localhost:8080/health > /dev/null; then
  echo "✅ 服务正常运行"
else
  echo "❌ 服务异常"
  exit 1
fi

# ❌ 错误：& 被 shell 解释
curl https://api.example.com/data?page=1&size=10

# ✅ 正确：用引号包裹
curl "https://api.example.com/data?page=1&size=10"