Struct RequestOptions 

pub struct RequestOptions {
    pub extra_headers: HashMap<String, String>,
    pub extra_query: HashMap<String, String>,
    pub extra_body: Option<Value>,
    pub timeout: Option<Duration>,
}

单次请求覆盖项。

优先级：调用级 RequestOptions > 客户端默认配置。

Fields

extra_headers: HashMap<String, String>

追加/覆盖本次请求的 HTTP 头。

典型用途：注入追踪头、灰度头、临时鉴权头。

extra_query: HashMap<String, String>

追加本次请求的查询参数。

与客户端默认查询参数合并；同名键以本字段写入顺序参与拼接。

extra_body: Option<Value>

追加到 JSON 请求体的额外字段。

• 当原请求体与该值均为对象时，按键合并，冲突键由 extra_body 覆盖。
• 非对象场景下，extra_body 将直接替换请求体。

timeout: Option<Duration>

覆盖本次请求超时（含连接后请求阶段）。

Implementations

impl RequestOptions

pub fn new() -> Self

创建空覆盖项，等价于 Default::default()。

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

追加一个请求头。

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

追加一个查询参数。

pub fn extra_body(self, value: Value) -> Self

追加 JSON 请求体扩展字段。

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

设置本次请求超时覆盖值。

Trait Implementations

impl Clone for RequestOptions

fn clone(&self) -> RequestOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RequestOptions

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

Formats the value using the given formatter.

impl Default for RequestOptions

fn default() -> RequestOptions

Returns the “default value” for a type.