Когда использовать curl
Команда curl проверяет ответы HTTP, скачивает ресурсы и обращается к API с сервера. Различайте успешную передачу и успешный ответ приложения, задавайте тайм-аут и не сохраняйте токены аутентификации в общедоступных примерах.
Синтаксис
curl [ПАРАМЕТРЫ] URLКвадратные скобки обозначают необязательные аргументы, многоточие — повторение. Замените условные имена файлов, пользователей и серверов своими значениями.
Основные параметры и аргументы
Примеры использования
Проверить заголовки сайта
curl -I https://example.comВыполняется запрос только заголовка; некоторые службы обрабатывают это иначе, чем обычный запрос контента.
Скачать файл с обработкой HTTP-ошибок
curl --fail --location --output ./page.html https://example.comВыполняются перенаправления, и тело ответа заменяет указанный локальный файл; Состояния ошибок HTTP приводят к сбою.
Запросить JSON с ограничением времени
curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/statusЗапрашивается ответ JSON с ограниченной общей продолжительностью; конечная точка должна фактически предоставить этот API.
Особенности и ограничения
- При HTTPS сертификат проверяется по умолчанию; не отключайте проверку через -k без отдельной причины.
- Не помещайте реальные токены или пароли в историю команд и не запускайте скачанные скрипты без проверки.
Частые вопросы и решение проблем
Почему curl завершается успешно, когда сервер возвращает страницу с ошибкой?
Без опции сбоя получение ответа об ошибке HTTP все равно может считаться успешной передачей. Проверьте статус HTTP и статус завершения команды.
Должен ли я отключить проверку сертификата, чтобы исправить HTTPS?
Не игнорируйте доверие как обычное решение. Вместо этого проверьте имя хоста, системное время, цепочку сертификатов сервера и конфигурацию доверенного центра сертификации.
Подробная справка
Параметры могут зависеть от установленной версии и дистрибутива. Проверьте справку с помощью следующей команды: man curl.