Конвертувати curl у Rust

Q: Що таке Rust reqwest?

reqwest — найпопулярніший HTTP-клієнт для Rust, побудований на базі hyper. Він надає як блокуючі, так і асинхронні API, автоматичну серіалізацію JSON через serde, TLS, обробку cookies та підтримку проксі. Додайте за допомогою cargo add reqwest --features json. Це бібліотека за замовчуванням, яку curl2code використовує для конвертацій у Rust.

Q: reqwest проти hyper проти ureq — що варто використовувати?

reqwest — основний вибір для більшості проєктів: високорівневий, багатофункціональний та асинхронний. hyper — низькорівневий і дає максимальний контроль (reqwest побудований на ньому). ureq — мінімалістичний клієнт тільки з блокуючим API, без залежності від асинхронного середовища виконання. Для підходу зі стандартною бібліотекою дивіться curl у Go або curl у C.

Q: Як керувати автентифікацією в Rust?

Для Bearer: client.get(url).bearer_auth(token). Для Basic: client.get(url).basic_auth(user, Some(pass)). Або встановлюйте заголовки вручну через .header("Authorization", value). curl2code конвертує прапорці -u та -H 'Authorization: ...' у відповідні методи reqwest.

Q: Як надіслати multipart дані форми в Rust?

Використовуйте reqwest::multipart::Form: створіть через Form::new(), додайте текстові поля через .text("key", "value"), а файли через .file("field", path).await?. Передайте в client.post(url).multipart(form). curl2code обробляє прапорці -F для multipart у reqwest.

Q: Як обробляти помилки HTTP в Rust?

reqwest повертає Result, що обгортає Response при успіху або reqwest::Error при невдачі — використовуйте оператор ? для прокидання помилок. Перевіряйте response.status().is_success() або викликайте response.error_for_status()?, що перетворює статус-коди, відмінні від 2xx, на помилки. Система типів Rust гарантує, що всі шляхи помилок явно оброблені під час компіляції.

Q: Яке асинхронне середовище виконання потрібне для reqwest?

reqwest за замовчуванням потребує середовища tokio. Позначте вашу функцію main атрибутом #[tokio::main]. Для блокуючого використання без асинхронного середовища увімкніть функцію blocking і використовуйте reqwest::blocking::Client. curl2code за замовчуванням генерує асинхронний код із tokio. Для іншої асинхронної екосистеми дивіться curl у Go (горутини).

Q: Як встановити таймаути в Rust reqwest?

Встановіть на клієнті: Client::builder().timeout(Duration::from_secs(30)).connect_timeout(Duration::from_secs(10)).build()?. Для окремого запиту: client.get(url).timeout(Duration::from_secs(5)). Вони відображаються на прапорці curl --max-time та --connect-timeout.

Q: Як використовувати проксі з reqwest?

Встановіть проксі в білдері клієнта: Client::builder().proxy(Proxy::https("http://proxy:8080")?).build()?. Підтримуються HTTP, HTTPS та SOCKS5 проксі. reqwest також за замовчуванням підтримує змінні середовища HTTP_PROXY та HTTPS_PROXY. curl2code конвертує прапорці -x у конфігурацію проксі.

Q: Як надіслати POST-запит із тілом JSON у Rust?

Конвертуйте команду curl POST, таку як curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL, у Rust за допомогою curl2code. Згенерований код використовує client.post(url).json(&data).send().await?. curl2code автоматично виявляє прапорці -d/--data із вмістом JSON і встановлює відповідний заголовок Content-Type у коді reqwest.

Q: Як додати авторизацію за допомогою Bearer-токена у Rust?

Передайте curl -H "Authorization: Bearer YOUR_TOKEN" URL у curl2code, і він згенерує код reqwest із заголовком авторизації: .bearer_auth("YOUR_TOKEN"). curl2code виявляє Bearer-токени як у прапорцях -H "Authorization: Bearer ...", так і в --oauth2-bearer. Для Basic auth використовуйте -u user:pass.

curl2code конвертує команди curl у код Rust за допомогою крейта reqwest. Конвертація виконується у вашому браузері через WebAssembly для повної приватності. Для Go перегляньте наш конвертер curl у Go. Для C дивіться curl у C. Нижче наведено практичні приклади на Rust з використанням async/await.

Як скопіювати curl з вашого браузера

1
Відкрийте DevTools
Натисніть F12 або Ctrl+Shift+I, щоб відкрити інструменти розробника у вашому браузері.
2
Перейдіть на вкладку Network
Натисніть на вкладку Network і виконайте дію, яка ініціює HTTP-запит.
3
Скопіюйте як cURL
Клацніть правою кнопкою миші на запит → Copy → Copy as cURL. Потім вставте його вище.

Приклади коду на Rust

1Простий GET-запит

команда curl

curl https://api.example.com/users

Rust · reqwest

extern crate reqwest;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::blocking::Client::builder()
        .redirect(reqwest::redirect::Policy::none())
        .build()
        .unwrap();
    let res = client.get("https://api.example.com/users")
        .send()?
        .text()?;
    println!("{}", res);

    Ok(())
}

2POST із тілом JSON

команда curl

curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -d '{"name":"John","email":"john@example.com"}'

Rust · reqwest

extern crate reqwest;
use reqwest::header;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut headers = header::HeaderMap::new();
    headers.insert("Content-Type", "application/json".parse().unwrap());

    let client = reqwest::blocking::Client::builder()
        .redirect(reqwest::redirect::Policy::none())
        .build()
        .unwrap();
    let res = client.post("https://api.example.com/users")
        .headers(headers)
        .body("{\"name\":\"John\",\"email\":\"john@example.com\"}")
        .send()?
        .text()?;
    println!("{}", res);

    Ok(())
}

3Запит із Bearer-токеном

команда curl

curl https://api.example.com/me \
  -H "Authorization: Bearer token123"

Rust · reqwest

extern crate reqwest;
use reqwest::header;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut headers = header::HeaderMap::new();
    headers.insert("Authorization", "Bearer token123".parse().unwrap());

    let client = reqwest::blocking::Client::builder()
        .redirect(reqwest::redirect::Policy::none())
        .build()
        .unwrap();
    let res = client.get("https://api.example.com/me")
        .headers(headers)
        .send()?
        .text()?;
    println!("{}", res);

    Ok(())
}

4Завантаження форми Multipart

команда curl

curl -X POST https://api.example.com/upload \
  -F "file=@document.pdf" \
  -F "description=My file"

Rust · reqwest

extern crate reqwest;
use reqwest::blocking::multipart;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let form = multipart::Form::new()
        .file("file", "document.pdf")?
        .text("description", "My file");

    let client = reqwest::blocking::Client::builder()
        .redirect(reqwest::redirect::Policy::none())
        .build()
        .unwrap();
    let res = client.post("https://api.example.com/upload")
        .multipart(form)
        .send()?
        .text()?;
    println!("{}", res);

    Ok(())
}

5Користувацькі заголовки

команда curl

curl https://api.example.com/data \
  -H "X-API-Key: abc123" \
  -H "Accept: application/json" \
  -H "X-Request-ID: req-456"

Rust · reqwest

extern crate reqwest;
use reqwest::header;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut headers = header::HeaderMap::new();
    headers.insert("X-API-Key", "abc123".parse().unwrap());
    headers.insert("Accept", "application/json".parse().unwrap());
    headers.insert("X-Request-ID", "req-456".parse().unwrap());

    let client = reqwest::blocking::Client::builder()
        .redirect(reqwest::redirect::Policy::none())
        .build()
        .unwrap();
    let res = client.get("https://api.example.com/data")
        .headers(headers)
        .send()?
        .text()?;
    println!("{}", res);

    Ok(())
}

Часті запитання

Що таке Rust reqwest?

reqwest — найпопулярніший HTTP-клієнт для Rust, побудований на базі hyper. Він надає як блокуючі, так і асинхронні API, автоматичну серіалізацію JSON через serde, TLS, обробку cookies та підтримку проксі. Додайте за допомогою cargo add reqwest --features json. Це бібліотека за замовчуванням, яку curl2code використовує для конвертацій у Rust.

reqwest проти hyper проти ureq — що варто використовувати?

reqwest — основний вибір для більшості проєктів: високорівневий, багатофункціональний та асинхронний. hyper — низькорівневий і дає максимальний контроль (reqwest побудований на ньому). ureq — мінімалістичний клієнт тільки з блокуючим API, без залежності від асинхронного середовища виконання. Для підходу зі стандартною бібліотекою дивіться curl у Go або curl у C.

Як керувати автентифікацією в Rust?

Для Bearer: client.get(url).bearer_auth(token). Для Basic: client.get(url).basic_auth(user, Some(pass)). Або встановлюйте заголовки вручну через .header("Authorization", value). curl2code конвертує прапорці -u та -H 'Authorization: ...' у відповідні методи reqwest.

Як надіслати multipart дані форми в Rust?

Використовуйте reqwest::multipart::Form: створіть через Form::new(), додайте текстові поля через .text("key", "value"), а файли через .file("field", path).await?. Передайте в client.post(url).multipart(form). curl2code обробляє прапорці -F для multipart у reqwest.

Як обробляти помилки HTTP в Rust?

reqwest повертає Result, що обгортає Response при успіху або reqwest::Error при невдачі — використовуйте оператор ? для прокидання помилок. Перевіряйте response.status().is_success() або викликайте response.error_for_status()?, що перетворює статус-коди, відмінні від 2xx, на помилки. Система типів Rust гарантує, що всі шляхи помилок явно оброблені під час компіляції.

Яке асинхронне середовище виконання потрібне для reqwest?

reqwest за замовчуванням потребує середовища tokio. Позначте вашу функцію main атрибутом #[tokio::main]. Для блокуючого використання без асинхронного середовища увімкніть функцію blocking і використовуйте reqwest::blocking::Client. curl2code за замовчуванням генерує асинхронний код із tokio. Для іншої асинхронної екосистеми дивіться curl у Go (горутини).

Як встановити таймаути в Rust reqwest?

Встановіть на клієнті: Client::builder().timeout(Duration::from_secs(30)).connect_timeout(Duration::from_secs(10)).build()?. Для окремого запиту: client.get(url).timeout(Duration::from_secs(5)). Вони відображаються на прапорці curl --max-time та --connect-timeout.

Як використовувати проксі з reqwest?

Встановіть проксі в білдері клієнта: Client::builder().proxy(Proxy::https("http://proxy:8080")?).build()?. Підтримуються HTTP, HTTPS та SOCKS5 проксі. reqwest також за замовчуванням підтримує змінні середовища HTTP_PROXY та HTTPS_PROXY. curl2code конвертує прапорці -x у конфігурацію проксі.

Як надіслати POST-запит із тілом JSON у Rust?

Конвертуйте команду curl POST, таку як curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL, у Rust за допомогою curl2code. Згенерований код використовує client.post(url).json(&data).send().await?. curl2code автоматично виявляє прапорці -d/--data із вмістом JSON і встановлює відповідний заголовок Content-Type у коді reqwest.

Як додати авторизацію за допомогою Bearer-токена у Rust?

Передайте curl -H "Authorization: Bearer YOUR_TOKEN" URL у curl2code, і він згенерує код reqwest із заголовком авторизації: .bearer_auth("YOUR_TOKEN"). curl2code виявляє Bearer-токени як у прапорцях -H "Authorization: Bearer ...", так і в --oauth2-bearer. Для Basic auth використовуйте -u user:pass.

Як встановити заголовок Content-Type у Rust?

curl2code конвертує curl -H "Content-Type: application/json" URL у код reqwest із відповідним заголовком: .header("Content-Type", "application/json"). Для даних -d curl за замовчуванням використовує application/x-www-form-urlencoded; для завантаження форм -F використовується multipart/form-data. curl2code зіставляє кожен варіант із правильним reqwest API.

Корисні посилання

Документація reqwest

docs.rs

Довідник стандартної бібліотеки

hyper.rs

Сторінка man для curl

curl.se

Посібники з curl

Коди помилок curl

Знайдіть будь-який код завершення curl — причини, виправлення та поради з налагодження.

Завантаження файлів за допомогою curl

Зберігайте файли з -o, -O, слідкуйте за перенаправленнями, відновлюйте завантаження та інше.

SSL, TLS та проксі

Налаштування сертифікатів, версій TLS, HTTP/SOCKS-проксі та власного DNS.

Як скопіювати curl з вашого браузера

Приклади коду на Rust

1Простий GET-запит

2POST із тілом JSON

3Запит із Bearer-токеном

4Завантаження форми Multipart

5Користувацькі заголовки

Часті запитання

Корисні посилання

Посібники з curl

Конвертувати curl в інші мови

Приклади коду на Rust

1Простий GET-запит

2POST із тілом JSON

3Запит із Bearer-токеном

4Завантаження форми Multipart

5Користувацькі заголовки