reqwest

reqwest

An ergonomic, batteries-included HTTP Client for Rust.

• Async and blocking Clients
• Plain bodies, JSON, urlencoded, multipart
• Customizable redirect policy
• HTTP Proxies
• HTTPS via rustls (or optionally, system-native TLS)
• Cookie Store
• WASM

Example

This asynchronous example uses Tokio and enables some optional features, so your Cargo.toml could look like this:

[dependencies]

reqwest = { version = "0.13", features = ["json"] }

tokio = { version = "1", features = ["full"] }

And then the code:

use std::collections::HashMap;

#[tokio::main]

async fn main() -> Result<(), Box<dyn std::error::Error>> {

    let resp = reqwest::get("https://httpbin.org/ip")

        .await?

        .json::<HashMap<String, String>>()

        .await?;

    println!("{resp:#?}");

    Ok(())

}

Commercial Support

For private advice, support, reviews, access to the maintainer, and the like, reach out for commercial support.

Requirements

By default, Reqwest uses rustls, but when the native-tls feature is enabled it will use the operating system TLS framework if available, meaning Windows and macOS. On Linux, it will use the available OpenSSL (see https://docs.rs/openssl for supported versions and more details) or fail to build if not found. Alternatively you can enable the native-tls-vendored feature to compile a copy of OpenSSL.

License

Licensed under either of

• Apache License, Version 2.0 ( or http://apache.org/licenses/LICENSE-2.0)
• MIT license ( or http://opensource.org/licenses/MIT)

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Sponsors

Support this project by becoming a sponsor.