Struct ApiRequest 

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

简化的API请求结构

Implementations

impl<R> ApiRequest<R>

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

创建 GET 请求

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

创建 POST 请求

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

创建 PUT 请求

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

创建 PATCH 请求

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

创建 DELETE 请求

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

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

添加单个请求头

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

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

添加单个查询参数

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

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

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

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

设置请求体

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

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

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

where T: Serialize,

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

pub fn timeout(self, duration: Duration) -> ApiRequest<R>

设置请求超时时间

pub fn with_supported_access_token_types( self, token_types: Vec<AccessTokenType>, ) -> ApiRequest<R>

覆盖当前请求支持的访问令牌类型。

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) -> ApiRequest<R>

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

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

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

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

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

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

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

Trait Implementations

impl<R> Clone for ApiRequest<R>

where R: Clone,

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 for ApiRequest<R>

where R: Debug,

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

Formats the value using the given formatter.

impl<R> Default for ApiRequest<R>

fn default() -> ApiRequest<R>

Returns the “default value” for a type.