curl

Описание

curl (Client URL) — утилита командной строки для передачи данных с поддержкой более 25 протоколов: HTTP, HTTPS, FTP, FTPS, SCP, SFTP, IMAP, SMTP и многих других. Разработана Даниэлем Стенбергом в 1997 году, сегодня входит в состав практически всех Linux-дистрибутивов, macOS и доступна на Windows. curl лежит в основе популярной библиотеки libcurl, которую используют тысячи приложений.

Основные применения: тестирование REST API, скачивание файлов, отладка HTTP-запросов, работа с веб-сервисами из скриптов, проверка заголовков ответов, загрузка файлов на сервер. В отличие от браузера, curl показывает полный цикл запроса/ответа с заголовками, кодами статусов и временными метриками — это делает её незаменимым инструментом для разработчиков и DevOps.

curl работает в конвейере: принимает URL как аргумент, отправляет запрос, выводит тело ответа в stdout. Это позволяет комбинировать её с jq для обработки JSON, с grep для фильтрации, с перенаправлением в файл для сохранения. Флаги -v и --trace показывают полный дамп соединения на уровне байтов.

Синтаксис

Флаги и опции

Паттерны использования

# Простой GET
curl https://api.example.com/users

# С заголовком авторизации
curl -H "Authorization: Bearer TOKEN" \
     https://api.example.com/users

# Форматировать JSON через jq
curl -s https://api.example.com/users | jq '.[]'

# POST с JSON
curl -X POST \
     -H "Content-Type: application/json" \
     -d '{"name":"Alice","email":"alice@ex.com"}' \
     https://api.example.com/users

# Из файла
curl -X POST \
     -H "Content-Type: application/json" \
     -d @payload.json \
     https://api.example.com/users

# Сохранить с оригинальным именем
curl -O -L https://example.com/archive.tar.gz

# Сохранить с указанным именем
curl -o myapp.tar.gz \
     https://releases.example.com/v1.2.tar.gz

# Продолжить прерванную загрузку
curl -C - -O https://example.com/bigfile.iso

# Только заголовки (HEAD-запрос)
curl -I https://example.com

# Подробный вывод (запрос + ответ)
curl -v https://api.example.com/health

# Только HTTP-код
curl -s -o /dev/null -w "%{http_code}" \
     https://example.com

# Multipart form (как )
curl -F "file=@photo.jpg" \
     -F "description=My photo" \
     https://api.example.com/upload

# PUT с файлом
curl -X PUT \
     -H "Content-Type: application/octet-stream" \
     --data-binary @firmware.bin \
     https://api.example.com/device/firmware

# Логин, сохранить cookies
curl -c cookies.txt \
     -d "user=admin&pass=secret" \
     https://example.com/login

# Следующий запрос с cookies
curl -b cookies.txt \
     https://example.com/dashboard

# Проверить производительность
curl -w "DNS: %{time_namelookup}s\nConnect: %{time_connect}s\nTotal: %{time_total}s\n" \
     -o /dev/null -s https://example.com

Советы и предупреждения