Отправить post запрос windows - Windowsa.top - ваш верный помощник с OS Windows

Узнайте о запросе cURL POST, что это такое, как отправить запрос POST с помощью cURL и многое другое.

4 мин. чтения

curl – это инструмент командной строки для передачи данных по различным сетевым протоколам. Доступный на всех основных операционных системах, curl стал стандартным инструментом для отправки HTTP-запросов из командной строки.

Кроссплатформенная утилита curl поддерживает такие протоколы, как HTTP, HTTPS, FTP и IMAP, что позволяет легко отправлять запросы к API и парсить веб-сайты с помощью curl. Благодаря широкой доступности и поддержке множества протоколов, вы часто можете встретить ссылки на curl в документации по REST API как на быстрый способ тестирования вызовов API непосредственно из командной строки:

Узнайте, как отправлять POST-запросы с помощью curl из командной строки

В этой статье вы узнаете, как отправлять POST-запросы с помощью curl из командной строки.

Что такое POST-запрос

POST-запрос – это метод HTTP для отправки данных на сервер, один из самых распространенных методов HTTP.

Когда вы отправляете POST-запрос, передаваемые данные включаются в тело запроса. Это позволяет отправлять данные более скрытно, чем в URL (как в случае с GET-запросом). Вы также можете отправить значительно больше данных в POST-запросе, обходя ограничения на длину URL, накладываемые браузерами на GET-запросы.

POST-запросы часто используются для отправки форм, загрузки файлов или передачи JSON-данных в API. По сравнению с GET, POST-запросы обычно не кэшируются, и данные не отображаются в истории браузера, поскольку они содержатся в теле запроса.

Как отправить POST-запрос с помощью curl

Прежде чем приступить к этому уроку, вам необходимо установить curl на свой компьютер. Выполните следующую команду, чтобы проверить, установлен ли curl:

curl --version

Если вы получаете ошибку о том, что команда не найдена, вам нужно установить утилиту

Установите curl

Ниже приведены инструкции по установке curl на все основные операционные системы:

Windows

В Windows для установки curl можно использовать WinGet, менеджер пакетов по умолчанию в Windows 11:

winget install curl.curl

Chocolatey – это еще один менеджер пакетов для Windows, который позволяет установить curl с помощью следующей команды:

choco install curl

Linux

curl доступен в большинстве менеджеров пакетов Linux. На Ubuntu/Debian для установки curl используйте следующую команду:

apt-get install curl

Red Hat Enterprise Linux (RHEL), CentOS и Fedora позволяют установить curl с помощью Yellowdog Updater Modified (YUM), например, так:

yum install curl

Если вы используете OpenSUSE, вы можете установить curl с помощью следующей команды в терминале:

zypper install curl

Наконец, Arch Linux позволяет использовать pacman для установки curl с помощью этой команды:

pacman -Sy curl

macOS

Homebrew – это самый простой способ установить curl на macOS. Убедитесь, что у вас установлен Homebrew, а затем выполните следующую команду:

brew install curl

Теперь, когда вы установили curl на свою операционную систему, вы готовы узнать, как выполнять POST-запросы.

Выполните POST-запрос

curl позволяет указать несколько параметров при отправке POST-запросов. В следующих разделах будут показаны некоторые общие возможности curl, с которыми вы можете столкнуться при выполнении POST-запросов с помощью этой утилиты.

Укажите метод POST

При выполнении HTTP-запросов с помощью curl необходимо указать HTTP-метод, который вы хотите использовать. К HTTP-методам относятся GET, POST, PUT и DELETE. curl позволяет указать HTTP-метод, который вы хотите использовать, с помощью флага командной строки -X.

Например, чтобы отправить POST-запрос на https://httpbin.org/anything, вы можете выполнить в терминале следующую команду curl:

curl -X POST https://httpbin.org/anything

httpbin.org повторяет тело запроса и заголовки в ответе. Ваш ответ должен выглядеть следующим образом:

{
  "args": {},
  "data": "",
  "files": {},
  "form": {},
  "headers": {
    "Accept": "*/*",
    "Host": "httpbin.org",
    "User-Agent": "curl/8.1.2",
    "X-Amzn-Trace-Id": "Root=1-11111111-111111111111111111111111"
  },
  "json": null,
  "method": "POST",
  "origin": "0.0.0.0",
  "url": "https://httpbin.org/anything"
}

Флаг -X POST эквивалентен использованию флага --request POST, поэтому вы также можете выполнить следующую команду и получить тот же результат:

curl --request POST https://httpbin.org/anything

Ответ выглядит так же, как и предыдущий.

Подробнее о флагах -X и --request вы можете прочитать в официальной документации.

Установите тип содержимого

При отправке POST-запроса важно указать тип отправляемого содержимого в теле запроса, чтобы сервер мог правильно интерпретировать тело запроса. Вы можете использовать типы MIME в заголовке Content-Type в HTTP-запросе, чтобы указать формат тела запроса.

Например, если вы отправляете JSON в теле запроса, вам нужно указать веб-серверу, что он ожидает JSON-содержимое, установив в заголовке Content-Type значение application/json. Если вы отправляете XML, заголовок Content-Type должен быть application/xml. Для получения дополнительной информации ознакомьтесь с официальной документацией по Content-Type.

curl позволяет задать заголовки для HTTP-запроса с помощью флага -H. Например, если вы отправляете JSON в POST-запросе, следующая команда curl показывает, как вы можете установить заголовок Content-Type для запроса:

curl -X POST -H 'Content-Type: application/json' -d '{}' https://httpbin.org/anything

В ответе можно увидеть, что в заголовке Content-Type установлено значение application/json:

{
  "args": {},
  "data": "{}",
  "files": {},
  "form": {},
  "headers": {
    "Accept": "*/*",
    "Content-Length": "2",
    "Content-Type": "application/json",
    "Host": "httpbin.org",
    "User-Agent": "curl/8.1.2",
    "X-Amzn-Trace-Id": "Root=-11111111-111111111111111111111111"
  },
  "json": {},
  "method": "POST",
  "origin": "0.0.0.0",
  "url": "https://httpbin.org/anything"
}

Флаг -H также может быть указан с помощью более длинного флага --header. В этом случае ваша команда curl будет выглядеть следующим образом:

curl -X POST --header 'Content-Type: application/json' -d '{}' https://httpbin.org/anything

Ваш ответ будет выглядеть так же, как и предыдущий.

Отправьте данные

Вы могли заметить, что в предыдущих командах был флаг -d. Этот флаг позволяет указать данные для отправки в теле запроса. С помощью этого флага можно передать любую строку значений, заключенную в кавычки, например, так:

curl -X POST -H 'Content-Type: application/json' -d '{
    "FirstName": "Joe", 
    "LastName": "Soap" 
}' https://httpbin.org/anything

Вы заметите, что httpbin.org показывает данные тела, которые вы отправили, в свойстве data ответа.

Если у вас есть файл с данными, которые вы хотите, чтобы curl отправил в тело запроса, укажите имя файла с префиксом @. Следующая команда считывает содержимое файла body.json и отправляет его в теле запроса:

curl -X POST -H 'Content-Type: application/json' -d @body.json https://httpbin.org/anything

В этом случае файл body.json содержит следующее:

{
    "FirstName": "Joe",
    "LastName": "Soap"
}

При отправке этого сообщения httpbin.org должен вернуть следующий ответ:

{
  "args": {},
  "data": "{\t\"FirstName\": \"Joe\",\t\"LastName\": \"Soap\"}",
  "files": {},
  "form": {},
  "headers": {
    "Accept": "*/*",
    "Content-Length": "41",
    "Content-Type": "application/json",
    "Host": "httpbin.org",
    "User-Agent": "curl/8.1.2",
    "X-Amzn-Trace-Id": "Root=1-11111111-111111111111111111111111"
  },
  "json": {
    "FirstName": "Joe",
    "LastName": "Soap"
  },
  "method": "POST",
  "origin": "0.0.0.0",
  "url": "https://httpbin.org/anything"
}

Флаг--data ведет себя так же, как и -d, поэтому их можно использовать как взаимозаменяемые.

Отправьте данные в формате JSON

В предыдущем разделе вы узнали, как можно отправить JSON-данные, установив в заголовке Content-Type значение application/json, а затем передав JSON-данные с помощью флага -d. При отправке запроса также важно сообщить веб-серверу, какой формат данных вы ожидаете получить в ответ. Вы можете использовать заголовок Accept со значением application/json, чтобы сообщить веб-серверу, что вы хотите получить ответ в формате JSON.

Следующая команда отправляет запрос JSON на сервер и сообщает серверу, что вы хотите получить JSON в ответ:

curl -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
    "FirstName": "Joe",
    "LastName": "Soap"
}' https://httpbin.org/anything

Вы заметите, что свойства data и json в теле ответа содержат данные JSON, которые вы отправили в запросе:

{
  "args": {},
  "data": "{\n    \"FirstName\": \"Joe\",\n    \"LastName\": \"Soap\"\n}",
  "files": {},
  "form": {},
  "headers": {
    "Accept": "application/json",
    "Content-Length": "50",
    "Content-Type": "application/json",
    "Host": "httpbin.org",
    "User-Agent": "curl/8.1.2",
    "X-Amzn-Trace-Id": "Root=1-11111111-111111111111111111111111"
  },
  "json": {
    "FirstName": "Joe",
    "LastName": "Soap"
  },
  "method": "POST",
  "origin": "0.0.0.0",
  "url": "https://httpbin.org/anything"
}

Отправка и получение JSON-данных – обычное дело при отправке HTTP-запросов, поэтому curl предлагает флаг --json, который устанавливает для вас заголовки Content-Type и Accept и отправляет JSON-данные в теле запроса. Используя этот флаг, вы можете сократить свою команду для отправки JSON в POST-запросе:

curl -X POST --json '{
    "FirstName": "Joe",
    "LastName": "Soap"
}' https://httpbin.org/anything

Это дает тот же ответ, что и раньше:

{
  "args": {},
  "data": "{\n    \"FirstName\": \"Joe\",\n    \"LastName\": \"Soap\"\n}",
  "files": {},
  "form": {},
  "headers": {
    "Accept": "application/json",
    "Content-Length": "50",
    "Content-Type": "application/json",
    "Host": "httpbin.org",
    "User-Agent": "curl/8.1.2",
    "X-Amzn-Trace-Id": "Root=1-11111111-111111111111111111111111"
  },
  "json": {
    "FirstName": "Joe",
    "LastName": "Soap"
  },
  "method": "POST",
  "origin": "0.0.0.0",
  "url": "https://httpbin.org/anything"
}

Флаг--json был выпущен в версии 7.82 curl в марте 2022 года, поэтому перед его использованием убедитесь, что у вас установлена последняя версия curl.

Отправка XML-данных

Curl также позволяет отправлять данные в других форматах, например XML. Чтобы отправить XML-данные, необходимо установить в заголовке Content-Type значение application/xml и передать XML-данные в теле запроса с помощью флага -d. Вы также можете сообщить веб-серверу, что ожидаете получить ответ в формате XML, установив в заголовке Accept значение application/xml.

Следующая команда показывает, как можно отправить XML-объект в POST-запросе с помощью curl:

curl -X POST -H 'Content-Type: application/xml' -H 'Accept: application/xml' -d '<Person>
    <FirstName>Joe</FirstName>
    <LastName>Soap</LastName>
</Person>' https://httpbin.org/anything

Вы найдете данные XML-запроса в свойстве data, возвращаемом httpbin.org:

{
  "args": {},
  "data": "<Person>\n    <FirstName>Joe</FirstName>\n    <LastName>Soap</LastName>\n</Person>",
  "files": {},
  "form": {},
  "headers": {
    "Accept": "application/xml",
    "Content-Length": "79",
    "Content-Type": "application/xml",
    "Host": "httpbin.org",
    "User-Agent": "curl/8.1.2",
    "X-Amzn-Trace-Id": "Root=1-11111111-111111111111111111111111"
  },
  "json": null,
  "method": "POST",
  "origin": "0.0.0.0",
  "url": "https://httpbin.org/anything"
}

Отправьте данные формы

Вы можете использовать FormData для отправки пар ключ-значение данных на веб-сервер. Как следует из названия, этот формат данных используется при отправке формы на веб-странице. Пары ключ-значение содержат имя поля и значение.

curl позволяет указывать FormData с помощью флага-F или –form. При использовании этого флага укажите имя и значение поля в следующем формате: -F <name=content> or --form <name=content>.

Следующий фрагмент показывает команду curl, которая отправляет POST-запрос с использованием FormData с полями FirstName и LastName:

curl -X POST -F FirstName=Joe -F LastName=Soap https://httpbin.org/anything

Имена и значения полей формы вы найдете в свойстве form объекта ответа httpbin.org:

{
  "args": {},
  "data": "",
  "files": {},
  "form": {
    "FirstName": "Joe",
    "LastName": "Soap"
  },
  "headers": {
    "Accept": "*/*",
    "Content-Length": "248",
    "Content-Type": "multipart/form-data; boundary=------------------------e2bb56049a60b8b8",
    "Host": "httpbin.org",
    "User-Agent": "curl/8.1.2",
    "X-Amzn-Trace-Id": "Root=1-11111111-111111111111111111111111"
  },
  "json": null,
  "method": "POST",
  "origin": "0.0.0.0",
  "url": "https://httpbin.org/anything"
}

Используйте флаг -F для каждого поля, которое вы хотите отправить на сервер.

Загрузите файлы

Вы можете использовать FormData для загрузки файлов в POST-запросе, прикрепляя файл к полю. Чтобы сообщить curl о том, что поле FormData содержит файл, введите путь к файлу в значение поля с префиксом @.

Следующая команда curl загружает файл Contract.pdf в ваш рабочий каталог. Для загрузки файла команда использует поле под названием File:

curl -X POST -F [email protected] https://httpbin.org/anything

Ответ содержит весь файл, поэтому он длинный, но должен выглядеть так:

{
  "args": {},
  "data": "",
  "files": {
    "File": "..."
  },
  "form": {},
  "headers": {
    "Accept": "*/*",
    "Content-Length": "246",
    "Content-Type": "multipart/form-data; boundary=------------------------19ed1fc3be4d30c7",
    "Host": "httpbin.org",
    "User-Agent": "curl/8.1.2",
    "X-Amzn-Trace-Id": "Root=1-11111111-111111111111111111111111"
  },
  "json": null,
  "method": "POST",
  "origin": "0.0.0.0",
  "url": "https://httpbin.org/anything"
}

Отправьте учетные данные

Многие конечные точки HTTP требуют аутентификации для отправки запросов. Веб-сервер решает, какой метод аутентификации следует использовать. Одним из таких методов является базовая схема аутентификации, которая позволяет отправлять в запросе учетные данные, состоящие из имени пользователя и пароля. Затем сервер проверяет учетные данные и, если они верны, обрабатывает запрос

сurl упрощает отправку базовых учетных данных аутентификации с помощью флага -u или --user. Затем вы указываете имя пользователя и пароль, разделяя их символом : (двоеточие), например: -u <username:password>.

Следующий фрагмент использует curl для отправки POST-запроса с учетными данными пользователя и телом в формате JSON:

curl -X POST -u 'admin:password123' --json '{
    "FirstName": "Joe",
    "LastName": "Soap"
}' https://httpbin.org/anything

Обратите внимание, как curl кодирует имя пользователя и пароль и отправляет их в заголовке Authorization:

{
  "args": {},
  "data": "{\n    \"FirstName\": \"Joe\",\n    \"LastName\": \"Soap\"\n}",
  "files": {},
  "form": {},
  "headers": {
    "Accept": "application/json",
    "Authorization": "Basic YWRtaW46cGFzc3dvcmQxMjM=",
    "Content-Length": "50",
    "Content-Type": "application/json",
    "Host": "httpbin.org",
    "User-Agent": "curl/8.1.2",
    "X-Amzn-Trace-Id": "Root=1-11111111-111111111111111111111111"
  },
  "json": {
    "FirstName": "Joe",
    "LastName": "Soap"
  },
  "method": "POST",
  "origin": "0.0.0.0",
  "url": "https://httpbin.org/anything"
}

Заключение

В этой статье вы узнали, как отправлять POST-запросы с помощью утилиты командной строки curl. Вы поняли, как использовать флаг -X, чтобы указать, что вы хотите отправить POST-запрос. Вы также установили заголовки Content-Type и Accept с помощью флагов -H и ---header, чтобы веб-сервер знал, в каком формате отправляются данные. Чтобы отправить данные в теле запроса, используйте флаг -d вместе с данными, которые вы хотите отправить.

Вы также увидели несколько примеров отправки нескольких типов данных, включая JSON, XML и FormDataa, и узнали, как отправлять базовые учетные данные аутентификации в запросе с помощью флагов -u и --user.

Хотя в этой статье были показаны основные флаги, входящие в состав curl, и способы их использования, curl предлагает больше возможностей, которые вы можете изучить, включая использование переменных, отправку cookies с запросами и отправку запросов с помощью прокси. Многие языки программирования также предоставляют библиотеки, позволяющие работать с curl из этого языка, включая Python, Node.js и Rust.

Ищете решение для скрапинга? Поговорите с одним из наших экспертов по данным и узнайте, какой из наших продуктов лучше всего подходит для ваших потребностей.

Кредитная карта не требуется

Источник

#статьи

24 окт 2024
0

Осваиваем швейцарский нож для взаимодействия с сетевыми протоколами.

Иллюстрация: Оля Ежак для Skillbox Media

Филолог и технарь, пишет об IT так, что поймут даже новички. Коммерческий редактор, автор технических статей для vc.ru и «Хабра».

Curl (Client URL, или «Клиентский URL») — это инструмент командной строки, предназначенный для передачи данных по различным сетевым протоколам. Он помогает разработчикам, системным администраторам и другим специалистам выполнять HTTP-запросы, загружать файлы, тестировать API и решать множество задач по отладке веб-приложений.

Давайте сразу проверим Curl в действии. Для этого откройте на своём компьютере терминал, скопируйте следующую команду и нажмите Enter:


curl https://httpbin.org/ip

После ввода команды Curl отправит GET-запрос на сервис httpbin.org, который обработает запрос и вернёт ваш текущий IP-адрес в формате JSON:


C:\Users\user>curl https://httpbin.org/ip
{
  "origin": "95.165.134.78"
}

Похожим образом Curl позволяет легко взаимодействовать с различными API и получать нужную информацию. Теперь поговорим об этом подробней.

Содержание

Описание Curl
Установка и запуск
Синтаксис команд
Использование Curl

GET-запрос
POST-запрос
Скачивание файла
Вывод заголовков
Аутентификация
Следование редиректам
Загрузка файла

Подборка ресурсов для работы с Curl

В 1997 году шведский программист Даниэль Стенберг разработал утилиту httpget — инструмент для загрузки валютных курсов через IRC-бота. Если вы хотели узнать текущий курс доллара, процесс выглядел примерно так:

Бот подключался к сайту с актуальными курсами валют.
Программа httpget загружала страницу и извлекала нужные данные о курсе доллара. Например, 1 USD = 30 RUB ?
Затем она передавала эту информацию IRC-боту, который отвечал на ваш запрос в IRC-чате.

Проект привлёк внимание многих разработчиков, поскольку решал актуальную проблему того времени — загрузку данных из интернета. До появления httpget разработчикам приходилось создавать отдельные скрипты для каждого случая получения данных. Программа позволяла получить нужную информацию всего несколькими простыми командами.

Со временем проект HTTPget сменил название на Urlget, а затем на Curl. Сегодня Curl — это кросс-платформенная утилита командной строки, которая позволяет передавать или загружать данные с сервера, устанавливая подключение через различные протоколы: HTTP, HTTPS, FTP, SFTP, TFTP, SCP, Telnet, DICT, LDAP, POP3, IMAP, SMTP и другие.

Сейчас, помимо Curl, существуют и другие инструменты для работы с HTTP-запросами. Вот некоторые из популярных:

Wget — утилита командной строки для загрузки файлов, удобная для рекурсивной загрузки и работы с FTP-протоколом.
Postman — графический инструмент для тестирования API. Он лучше Curl подходит для сложных запросов и визуализации ответов, однако уступает в гибкости при автоматизации задач.
HTTPie — это современный аналог Curl с упрощённым синтаксисом, цветным выводом результатов и менее широким набором функций.
Axios — это JavaScript-библиотека для выполнения HTTP-запросов. Она удобна для веб-разработки, но ограничена средой JavaScript: Axios можно использовать только в браузерах для HTTP-запросов на стороне клиента и в Node.js для запросов на стороне сервера.

Несмотря на множество альтернатив, Curl остаётся популярным инструментом благодаря своей универсальности, широкой поддержке протоколов и кросс-платформенности. Давайте перейдём к его установке.

? Возможности Curl и других бесплатных инструментов для передачи данных: сравнительная таблица

В современных операционных системах утилита Curl обычно установлена по умолчанию. Для проверки откройте терминал и введите команду:


curl --version

Должен отобразиться номер версии и поддерживаемые протоколы:

Результат вывода после проверки версии Curl в командной строке.
Скриншот: Windows 10 / Skillbox Media

Если Curl не установлен, в терминале появится сообщение об ошибке:


'curl' is not recognized as an internal or external command,
operable program or batch file.

Если вы видите подобное сообщение, значит, программа Curl недоступна и её нужно загрузить. Способ установки зависит от операционной системы.

Если у вас macOS, установите менеджер пакетов Homebrew и выполните в терминале следующую команду:


brew install curl

После завершения установки проверьте версию Curl:


curl --version

Если у вас Linux, то способ установки будет зависеть от дистрибутива. Для Ubuntu или Debian выполните последовательно следующие команды:


sudo apt-get update 
sudo apt-get install curl

Для Fedora:


sudo dnf install curl

Для CentOS или RHEL:


sudo yum install curl

Для Arch Linux:


sudo pacman -S curl

После установки проверьте версию Curl командой:


curl --version

Если у вас Windows 10 или 11, откройте PowerShell или командную строку от имени администратора и установите Curl через менеджер пакетов:


winget install curl

После установки перезапустите PowerShell или командную строку и проверьте установку:


curl --version

Если у вас Windows 7, 8 или 8.1, скачайте архив с утилитой с сайта curl.se через браузер Pale Moon. Современные браузеры могут не поддерживаться устаревшими версиями Windows или блокировать загрузку по соображениям безопасности. Pale Moon — это легковесный браузер, позволяющий загружать сторонние файлы без подобных ограничений.

После загрузки распакуйте папку из архива, переименуйте её в Curl и поместите в удобное место. Например, наша папка находится по пути: C:/Program Files/Curl. Затем откройте папку Curl, перейдите в подпапку bin и скопируйте полный путь к этому каталогу: