Что делает этот инструмент?

Конвертер cURL в код превращает команду curl в код, который отправляет тот же HTTP-запрос из вашей программы. Он генерирует три вида кода:

  • JavaScript (fetch): API fetch, встроенный в браузеры, Deno, Bun и Node.js.
  • Node.js (Axios): популярную библиотеку Axios с модулями Node.js для работы с файлами и настройки TLS.
  • Python (Requests): библиотеку Requests.

Обычно команду можно получить в инструментах разработчика браузера: на вкладке «Сеть» щёлкните правой кнопкой мыши по запросу и выберите «Копировать как cURL». В документации API примеры тоже часто приводятся в виде команд curl.

Как пользоваться

  1. Вставьте команду curl. Длинные команды можно разбить на несколько строк, поставив обратную косую черту в конце каждой строки, как того ожидает командная оболочка.
  2. Выберите язык.
  3. Скопируйте код или скачайте его в виде файла (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, сертификаты и прокси
  • Комментарии обо всём, что невозможно преобразовать
  • Понятные сообщения об ошибках в команде
  • Копирование и скачивание кода
  • Работает в браузере