Struct RequestBuilder 

pub struct RequestBuilder { /* private fields */ }

请求构建器

通过流畅 API 构建 HTTP 请求

Example

let response = client
    .request(Method::POST, "https://api.example.com/users")
    .header("X-Custom", "value")
    .bearer_auth("token")
    .json(&user_data)
    .send()
    .await?;

Implementations

impl RequestBuilder

pub fn new(method: Method, url: impl Into<String>) -> Self

创建新的请求构建器

pub fn header(self, name: impl Into<String>, value: impl Into<String>) -> Self

添加请求头

pub fn headers( self, headers: impl IntoIterator<Item = (impl Into<String>, impl Into<String>)>, ) -> Self

批量添加请求头

pub fn bearer_auth(self, token: impl AsRef<str>) -> Self

设置 Bearer Token 认证

pub fn basic_auth( self, username: impl AsRef<str>, password: Option<&str>, ) -> Self

设置 Basic Auth 认证

pub fn query(self, key: impl Into<String>, value: impl Into<String>) -> Self

添加查询参数

pub fn queries( self, params: impl IntoIterator<Item = (impl Into<String>, impl Into<String>)>, ) -> Self

批量添加查询参数

pub fn json<T: Serialize>(self, body: &T) -> Result<Self, HttpError>

设置 JSON 请求体

pub fn form<T: Serialize>(self, body: &T) -> Result<Self, HttpError>

设置表单请求体

pub fn body(self, bytes: impl Into<Vec<u8>>) -> Self

设置原始字节请求体

pub fn text(self, text: impl Into<String>) -> Self

设置文本请求体

pub fn timeout(self, timeout: Duration) -> Self

设置请求超时（覆盖客户端默认值）

pub fn max_retries(self, retries: u32) -> Self

设置此请求的重试次数（覆盖客户端默认值）

pub fn no_retry(self) -> Self

禁用此请求的重试

pub fn with_cancellation(self, token: CancellationToken) -> CancellableRequest

附加取消令牌，使请求可取消

Trait Implementations

impl Debug for RequestBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.