144 lines
4.1 KiB
Markdown
144 lines
4.1 KiB
Markdown
# reqwest-impersonate
|
|
|
|
A fork of reqwest used to impersonate the Chrome browser. Inspired by [curl-impersonate](https://github.com/lwthiker/curl-impersonate).
|
|
|
|
This crate was intended to be an experiment to learn more about TLS and HTTP2 fingerprinting. Some parts of reqwest may not have the code needed to work when used to copy Chrome.
|
|
|
|
It is currently missing HTTP/2 `PRIORITY` support. (PRs to [h2](https://github.com/hyperium/h2) are welcome)
|
|
|
|
**Notice:** This crate depends on patched dependencies. To use it, please add the following to your `Cargo.toml`.
|
|
|
|
```toml
|
|
[patch.crates-io]
|
|
hyper = { git = "https://github.com/4JX/hyper.git", branch = "v0.14.18-patched" }
|
|
h2 = { git = "https://github.com/4JX/h2.git", branch = "imp" }
|
|
```
|
|
|
|
These patches were made specifically for `reqwest-impersonate` to work, but I would appreciate if someone took the time to PR more "proper" versions to the parent projects.
|
|
|
|
## Example
|
|
|
|
`Cargo.toml`
|
|
|
|
```toml
|
|
reqwest-impersonate = { git = "https://github.com/4JX/reqwest-impersonate.git", default-features = false, features = [
|
|
"chrome",
|
|
"blocking",
|
|
] }
|
|
```
|
|
|
|
`main.rs`
|
|
|
|
```rs
|
|
use reqwest_impersonate::browser::ChromeVersion;
|
|
|
|
fn main() {
|
|
// Build a client to mimic Chrome 104
|
|
let client = reqwest_impersonate::blocking::Client::builder()
|
|
.chrome_builder(ChromeVersion::V104)
|
|
.build()
|
|
.unwrap();
|
|
|
|
// Use the API you're already familiar with
|
|
match client.get("https://yoururl.com").send() {
|
|
Ok(res) => {
|
|
println!("{:?}", res.text().unwrap());
|
|
}
|
|
Err(err) => {
|
|
dbg!(err);
|
|
}
|
|
};
|
|
}
|
|
```
|
|
|
|
## Original readme
|
|
|
|
[](https://crates.io/crates/reqwest)
|
|
[](https://docs.rs/reqwest)
|
|
[](./LICENSE-APACHE)
|
|
[](https://github.com/seanmonstar/reqwest/actions?query=workflow%3ACI)
|
|
|
|
An ergonomic, batteries-included HTTP Client for Rust.
|
|
|
|
- Plain bodies, JSON, urlencoded, multipart
|
|
- Customizable redirect policy
|
|
- HTTP Proxies
|
|
- HTTPS via system-native TLS (or optionally, rustls)
|
|
- Cookie Store
|
|
- WASM
|
|
- [Changelog](CHANGELOG.md)
|
|
|
|
## Example
|
|
|
|
This asynchronous example uses [Tokio](https://tokio.rs) and enables some
|
|
optional features, so your `Cargo.toml` could look like this:
|
|
|
|
```toml
|
|
[dependencies]
|
|
reqwest = { version = "0.11", features = ["json"] }
|
|
tokio = { version = "1", features = ["full"] }
|
|
```
|
|
|
|
And then the code:
|
|
|
|
```rust,no_run
|
|
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(())
|
|
}
|
|
```
|
|
|
|
## Blocking Client
|
|
|
|
There is an optional "blocking" client API that can be enabled:
|
|
|
|
```toml
|
|
[dependencies]
|
|
reqwest = { version = "0.11", features = ["blocking", "json"] }
|
|
```
|
|
|
|
```rust,no_run
|
|
use std::collections::HashMap;
|
|
|
|
fn main() -> Result<(), Box<dyn std::error::Error>> {
|
|
let resp = reqwest::blocking::get("https://httpbin.org/ip")?
|
|
.json::<HashMap<String, String>>()?;
|
|
println!("{:#?}", resp);
|
|
Ok(())
|
|
}
|
|
```
|
|
|
|
## Requirements
|
|
|
|
On Linux:
|
|
|
|
- OpenSSL 1.0.1, 1.0.2, 1.1.0, or 1.1.1 with headers (see <https://github.com/sfackler/rust-openssl>)
|
|
|
|
On Windows and macOS:
|
|
|
|
- Nothing.
|
|
|
|
Reqwest uses [rust-native-tls](https://github.com/sfackler/rust-native-tls),
|
|
which will use the operating system TLS framework if available, meaning Windows
|
|
and macOS. On Linux, it will use OpenSSL 1.1.
|
|
|
|
## License
|
|
|
|
Licensed under either of
|
|
|
|
- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or <http://apache.org/licenses/LICENSE-2.0>)
|
|
- MIT license ([LICENSE-MIT](LICENSE-MIT) 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.
|