Struct ApiRequest 

pub struct ApiRequest<R> { /* private fields */ }

简化的API请求结构

Implementations

impl<R> ApiRequest<R>

pub fn get(url: impl Into<String>) -> Self

创建 GET 请求

pub fn post(url: impl Into<String>) -> Self

创建 POST 请求

pub fn put(url: impl Into<String>) -> Self

创建 PUT 请求

pub fn patch(url: impl Into<String>) -> Self

创建 PATCH 请求

pub fn delete(url: impl Into<String>) -> Self

创建 DELETE 请求

pub fn header<K, V>(self, key: K, value: V) -> Self

where K: Into<String>, V: Into<String>,

添加单个请求头

pub fn query<K, V>(self, key: K, value: V) -> Self

where K: Into<String>, V: Into<String>,

添加单个查询参数

pub fn query_opt<K, V>(self, key: K, value: Option<V>) -> Self

where K: Into<String>, V: Into<String>,

添加可选查询参数，如果值为None则跳过

pub fn body(self, body: impl Into<RequestData>) -> Self

设置请求体

pub fn file_content(self, file: Vec<u8>) -> Self

设置文件内容 (用于 multipart 上传)

pub fn json_body<T>(self, body: &T) -> Self

where T: Serialize,

为任何可序列化的类型设置请求体

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

设置请求超时时间

pub fn build_url(&self) -> String

构建完整 URL（包含查询参数）

pub fn method(&self) -> &HttpMethod

获取 HTTP 方法

pub fn api_path(&self) -> &str

获取 API 路径（从 URL 中提取）

pub fn supported_access_token_types(&self) -> Vec<AccessTokenType>

获取支持的访问令牌类型

pub fn to_bytes(&self) -> Vec<u8>

将请求体转换为字节

pub fn headers_mut(&mut self) -> &mut HashMap<String, String>

获取 headers 的可变引用，用于直接插入多个 header

pub fn query_mut(&mut self) -> &mut HashMap<String, String>

获取 query 的可变引用，用于直接插入多个查询参数

pub fn file(&self) -> Vec<u8>

获取文件内容

pub fn request_option(self, option: RequestOption) -> Self

应用请求选项（兼容方法）

pub fn query_param<K, V>(self, key: K, value: V) -> Self

where K: Into<String>, V: Into<String>,

设置查询参数（兼容方法）

pub fn query_params<I, K, V>(self, params: I) -> Self

where I: IntoIterator<Item = (K, V)>, K: Into<String>, V: Into<String>,

设置多个查询参数（兼容方法）

Trait Implementations

impl<R: Clone> Clone for ApiRequest<R>

fn clone(&self) -> ApiRequest<R>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<R: Debug> Debug for ApiRequest<R>

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

Formats the value using the given formatter.

impl<R> Default for ApiRequest<R>

fn default() -> Self

Returns the “default value” for a type.