Преобразователь cURL в код
Преобразуйте команду curl в код на JavaScript с fetch, Axios или на Python с Requests, сохранив метод, заголовки, cookies, данные аутентификации и тело запроса. Работает в браузере.
Ввод
Вывод
Документация
Что делает этот инструмент?
Конвертер cURL в код превращает команду curl в код, который отправляет тот же HTTP-запрос из вашей программы. Он генерирует три вида кода:
- JavaScript (fetch): API fetch, встроенный в браузеры, Deno, Bun и Node.js.
- Node.js (Axios): популярную библиотеку Axios с модулями Node.js для работы с файлами и настройки TLS.
- Python (Requests): библиотеку Requests.
Обычно команду можно получить в инструментах разработчика браузера: на вкладке «Сеть» щёлкните правой кнопкой мыши по запросу и выберите «Копировать как cURL». В документации API примеры тоже часто приводятся в виде команд curl.
Как пользоваться
- Вставьте команду curl. Длинные команды можно разбить на несколько строк, поставив обратную косую черту в конце каждой строки, как того ожидает командная оболочка.
- Выберите язык.
- Скопируйте код или скачайте его в виде файла (
request.mjsдля JavaScript,request.pyдля Python).
Код обновляется по мере ввода. Если в команде есть ошибка, из-за которой curl не сможет выполнить её, например незакрытая кавычка или неизвестный параметр, инструмент укажет на неё.
Что преобразуется
- Метод, в том числе тот, который curl выбирает автоматически:
-dи-Fзадают POST,-I— HEAD, а-T— PUT. - URL, включая параметры запроса, добавленные с помощью
-Gили--url-query. - Заголовки из
-H, user agent из-A, referrer из-eи cookies из-b— в Python они преобразуются в словарьcookies. - Базовая аутентификация из
-uили URL с помощью встроенных средств каждой библиотеки, а также Bearer-токены из--oauth2-bearer. В Python также добавляется дайджест-аутентификация. - Тела запросов: JSON из
--jsonили заголовка Content-Type со значением JSON преобразуется в объект или словарь, данные формы из-d— вURLSearchParamsили словарь, а многочастные формы из-F— вFormDataили словарьfiles, включая загрузку файлов. - Тайм-аут из
--max-time(а в Python также--connect-timeout), параметр-kдля пропуска проверок TLS, сертификаты центра сертификации и клиента, а также прокси из-x.
Заголовки, которые curl добавляет самостоятельно, например собственный User-Agent, Accept: */* и Content-Length, не включаются: библиотеки отправляют их сами. Не включаются и параметры, влияющие только на отображение ответа в curl, например -s или -v.
Когда преобразование невозможно
Некоторые параметры не имеют эквивалента в библиотеке или языке. Они добавляются в виде комментариев в начале кода, чтобы ничего не пропало незаметно:
- Параметры без аналога, например
--retry, перечисляются в разделе «Не преобразовано». - fetch не может пропускать проверки TLS, использовать прокси или задавать тайм-аут подключения. Браузеры также не позволяют скриптам задавать заголовок Cookie, хотя Node.js это позволяет.
- Файлы, которые curl читает, например
-d @data.jsonили-F photo=@cat.jpg, считываются с диска в Node.js и Python. В браузерном JavaScript вместо них указывается шаблон, который нужно заменить, например файлом из элемента<input type="file">. - Если команда отправляет несколько запросов, код будет создан для первого из них.
Примеры
curl https://example.com/преобразуется вrequests.get("https://example.com/")в Python.curl -u ada:secret https://api.example.com/meпреобразуется вauth=("ada", "secret")в Python и в параметрauthв Axios.curl --json '{"item": "sourdough loaf"}' https://api.example.com/ordersпреобразуется вjson={"item": "sourdough loaf"}в Python и вJSON.stringify({ item: "sourdough loaf" })при использовании fetch.
Как это работает
Команда разбирается так же, как её разбирают командная оболочка и curl: учитываются кавычки, экранирование и продолжение команды на следующей строке. Для этого используется тот же анализатор, что и в валидаторе команд cURL на сайте. Затем запрос, который отправил бы curl, преобразуется в код. Всё происходит в браузере, поэтому команды с token или паролями не покидают ваше устройство.
Возможности
- JavaScript fetch, Node.js Axios и Python Requests
- Заголовки, cookies, базовая аутентификация и Bearer-аутентификация
- Тела запросов в форматах JSON, формы и многочастной формы, а также файлы
- Тайм-ауты, параметры TLS, сертификаты и прокси
- Комментарии обо всём, что невозможно преобразовать
- Понятные сообщения об ошибках в команде
- Копирование и скачивание кода
- Работает в браузере