What is this?
Reqwest is an easy and powerful HTTP client library for Rust — ergonomic and batteries-included, so the common things an HTTP client needs work out of the box.
Reqwest is an easy and powerful HTTP client library for Rust — ergonomic and batteries-included, so the common things an HTTP client needs work out of the box.Is it a library I call from my Rust code, or a standalone tool I run?It's a Rust crate: you add it as a dependency of your own project and call it in code — there is no executable to install or run on its own.
It's a Rust crate: you add it as a dependency of your own project and call it in code — there is no executable to install or run on its own.How do I start making requests with it?Add reqwest to your Cargo.toml, enabling the optional features you need, then send requests — asynchronously on Tokio, or through the built-in blocking client if you'd rather avoid async.
Add reqwest to your Cargo.toml, enabling the optional features you need, then send requests — asynchronously on Tokio, or through the built-in blocking client if you'd rather avoid async.Do I need to bring anything else, like Tokio or a TLS stack?The async API runs on Tokio. For HTTPS, reqwest uses rustls by default, so no system TLS setup is required; the native-tls feature switches to the OS TLS framework on Windows and macOS.
The async API runs on Tokio. For HTTPS, reqwest uses rustls by default, so no system TLS setup is required; the native-tls feature switches to the OS TLS framework on Windows and macOS.Are there any build pitfalls I should know about?With native-tls on Linux, reqwest links the system OpenSSL and the build fails if it isn't installed; the native-tls-vendored feature works around this by compiling a copy of OpenSSL.
With native-tls on Linux, reqwest links the system OpenSSL and the build fails if it isn't installed; the native-tls-vendored feature works around this by compiling a copy of OpenSSL.What does it cover out of the box beyond plain requests?Plain bodies, JSON, urlencoded forms and multipart uploads, a cookie store, HTTP proxies, a customizable redirect policy, and HTTPS are all built in — plus your choice of async or blocking clients.
Plain bodies, JSON, urlencoded forms and multipart uploads, a cookie store, HTTP proxies, a customizable redirect policy, and HTTPS are all built in — plus your choice of async or blocking clients.Can it run in the browser?Yes — WASM is a supported target, so you can compile reqwest to WebAssembly and use the same client API from web pages.
Yes — WASM is a supported target, so you can compile reqwest to WebAssembly and use the same client API from web pages.Is there paid support if I need help beyond GitHub issues?Yes — the author offers commercial support for private advice, reviews and direct access to the maintainer through the sponsor link in the README.
Yes — the author offers commercial support for private advice, reviews and direct access to the maintainer through the sponsor link in the README.Which topics is it in?https, http-client, async, tls, wasm, http, json, networking, rust, apache-2.0, server, library
https, http-client, async, tls, wasm, http, json, networking, rust, apache-2.0, server, library