curl: запросы из командной строки

API=localhost:8080/api

curl $API/users                       # GET, тело ответа в терминал
curl -i $API/users                    # с заголовками ответа
curl -I $API/users                    # только заголовки (метод HEAD)
curl -s $API/users                    # без индикатора прогресса
curl -sS $API/users                   # тихо, но ошибки показывать
curl -o users.json $API/users         # сохранить в файл
curl -v $API/users                    # подробно: заголовки запроса и ответа, TLS
curl "$API/users?page=2&limit=50"     # параметры в кавычках

curl -G $API/search --data-urlencode "q=привет мир" --data-urlencode "lang=ru"
# уйдёт GET /api/search?q=%D0%BF%D1%80%D0%B8...&lang=ru

# классический способ
curl -X POST $API/users \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"name": "Анна", "role": "admin"}'

# то же короче, curl сам выставит оба заголовка и метод
curl --json '{"name": "Анна", "role": "admin"}' $API/users

# тело из файла
curl --json @user.json $API/users

# частичное обновление и удаление
curl -X PATCH --json '{"role": "viewer"}' $API/users/42
curl -X DELETE $API/users/42

name="Анна \"Ника\""
jq -n --arg name "$name" '{name: $name, active: true}' | curl --json @- $API/users

# обычная форма: application/x-www-form-urlencoded
curl -d "login=anna" -d "remember=1" $API/login

# значение с пробелами и спецсимволами — с кодированием
curl --data-urlencode "comment=Цена 100% & доставка" $API/feedback

# multipart: поля и файлы
curl -F "title=Отчёт" -F "file=@report.pdf" $API/upload
curl -F "file=@photo.jpg;type=image/jpeg;filename=avatar.jpg" $API/avatar

# загрузить файл телом запроса, как делают хранилища объектов
curl -T backup.tar.gz $API/files/backup.tar.gz

curl -H "Authorization: Bearer $TOKEN" $API/me
curl -u anna:secret $API/admin          # Basic, curl сам закодирует в Base64
curl -u anna $API/admin                 # пароль спросит интерактивно
curl -H "X-Request-Id: $(uuidgen)" $API/orders
curl -H "Accept-Language: ru" $API/products
curl -A "my-script/1.0" $API/ping       # свой User-Agent

# войти и сохранить cookie в файл
curl -c cookies.txt -d "login=anna&password=secret" $API/login

# следующие запросы с этими cookie
curl -b cookies.txt $API/profile

# читать и обновлять одновременно
curl -b cookies.txt -c cookies.txt $API/cart

# передать cookie напрямую
curl -b "sid=a1b2c3; theme=dark" $API/profile

curl -L $API/old-path                      # пройти по всем перенаправлениям
curl -L --max-redirs 5 $API/old-path
curl -sIL $API/old-path | grep -i -E "^(HTTP|location)"   # показать цепочку
curl -LO "$URL"                            # скачать под исходным именем
curl -L -o app.tar.gz -C - "$URL"          # докачать, если файл уже частично есть
curl -L --limit-rate 2M -O "$URL"          # не быстрее 2 МБ/с

if ! curl -fsS -m 10 -o /dev/null "$API/health"; then
  echo "сервис не отвечает" >&2
  exit 1
fi

code=$(curl -s -o /dev/null -w '%{http_code}' "$API/health")
[[ "$code" == 200 ]] || echo "получили $code"

curl -fsS --retry 5 --retry-delay 2 --retry-all-errors -m 30 "$API/report" -o report.json

curl -s -o /dev/null -w '
dns:       %{time_namelookup}s
connect:   %{time_connect}s
tls:       %{time_appconnect}s
first byte:%{time_starttransfer}s
total:     %{time_total}s
code:      %{http_code}
size:      %{size_download} байт
' "$API/products"