Как выглядит синтаксис в cURL?

Синтаксис команды cURL

cURL (Client URL) — это мощная консольная утилита для передачи данных по различным сетевым протоколам (HTTP, HTTPS, FTP, FTPS, SCP, SFTP и др.). Синтаксис cURL гибок и включает множество опций, что делает его незаменимым инструментом для тестирования API, автоматизации запросов и отладки сетевых взаимодействий в QA Automation.

Базовая структура команды

Основной синтаксис выглядит так:

curl [опции/флаги] [URL]

• curl — вызов самой утилиты.
• [опции/флаги] — необязательные параметры, которые управляют поведением запроса (метод, заголовки, тело, аутентификация и т.д.).
• [URL] — обязательный адрес ресурса, к которому обращаемся.

Ключевые опции и примеры

1. Методы HTTP

По умолчанию cURL выполняет GET-запрос. Для других методов используются флаги:

# GET (по умолчанию)
curl https://api.example.com/users

# POST
curl -X POST https://api.example.com/users

# Или с явным указанием метода
curl -X PUT https://api.example.com/users/1
curl -X DELETE https://api.example.com/users/1

2. Отправка данных в теле запроса

Для передачи данных (например, JSON или form-data):

# JSON данные с указанием Content-Type
curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -d '{"name": "Alice", "role": "QA"}'

# Form-urlencoded данные
curl -X POST https://api.example.com/login \
  -d "username=alice&password=secret"

# Чтение тела запроса из файла
curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -d @data.json

3. Заголовки (Headers)

Заголовки задаются с помощью флага -H:

curl -X GET https://api.example.com/profile \
  -H "Authorization: Bearer token123" \
  -H "Accept: application/json"

4. Файлы и загрузка

cURL позволяет загружать файлы или сохранять ответы:

# Загрузка файла на сервер (multipart/form-data)
curl -X POST https://api.example.com/upload \
  -F "file=@report.pdf"

# Сохранение ответа в файл
curl -o output.json https://api.example.com/data

# Или автоматическое именование по URL
curl -O https://example.com/files/document.zip

5. Аутентификация

Поддержка различных типов аутентификации:

# Базовая аутентификация (Basic Auth)
curl -u username:password https://api.example.com/secured

# Аутентификация через заголовок (см. выше)

6. Прокси и отладка

Для отладки и работы в сложных сетевых условиях:

# Включение подробного вывода (verbose mode)
curl -v https://api.example.com/users

# Указание прокси
curl -x http://proxy-server:8080 https://api.example.com

# Игнорирование SSL сертификатов (для тестовых сред)
curl -k https://self-signed.example.com

Комплексный пример для QA Automation

Вот типичный пример запроса для тестирования REST API:

curl -X POST https://staging-api.example.com/v1/orders \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9" \
  -H "X-Request-ID: $(uuidgen)" \
  -d '{
    "productId": 789,
    "quantity": 2,
    "customerNotes": "Тестовый заказ от автоматизации"
  }' \
  -w "\nHTTP Code: %{http_code}\nTotal Time: %{time_total}s\n" \
  -o response.json \
  -s

Разбор флагов:

• -w — вывод дополнительной информации (код ответа, время выполнения).
• -o — сохранение ответа в файл response.json для последующего парсинга.
• -s — тихий режим (без прогресс-бара и лишних сообщений).

Рекомендации для автоматизации

• Используйте скрипты — оборачивайте сложные cURL-запросы в bash- или Python-скрипты для воспроизводимости.
• Логируйте — сохраняйте запросы и ответы в логи для анализа падающих тестов.
• Переменные окружения — выносите чувствительные данные (токены, URLs) в переменные окружения.
• jq для JSON — сочетайте cURL с утилитой jq для парсинга JSON-ответов прямо в конвейере:

  curl -s https://api.example.com/users | jq '.[0].email'
  

cURL, благодаря своему лаконичному синтаксису и богатым возможностям, остается стандартом де-факто для быстрого тестирования API и интеграции в CI/CD пайплайны. В QA Automation его часто используют для smoke-тестов, проверки доступности эндпоинтов и создания простых нагрузочных тестов в комбинации с bash-скриптами.