Struct WebhookHandler 

pub struct WebhookHandler { /* private fields */ }

Webhook 处理器

负责验证 Webhook 请求签名和解析请求体。

Implementations

impl WebhookHandler

pub fn new(secret: String, path: String) -> Self

创建新的 Webhook 处理器

参数

• secret - 用于签名验证的密钥
• path - Webhook 端点路径

示例

use aster::auto_reply::webhook::WebhookHandler;

let handler = WebhookHandler::new(
    "my-secret".to_string(),
    "/webhook/auto-reply".to_string(),
);

pub fn path(&self) -> &str

获取端点路径

pub fn verify_signature(&self, payload: &[u8], signature: &str) -> bool

验证请求签名

使用 HMAC-SHA256 验证签名。签名格式支持：

• 纯 hex 字符串
• sha256=<hex> 格式（GitHub 风格）

参数

• payload - 请求体原始字节
• signature - 请求头中的签名

返回

签名验证通过返回 true，否则返回 false

Requirements

• 9.1: THE Webhook_Trigger SHALL validate request signature using secret
• 9.2: WHEN signature validation fails, THE Webhook_Trigger SHALL reject the request

pub fn parse_request(&self, body: &[u8]) -> Result<WebhookRequest, String>

解析请求体

将 JSON 请求体解析为 WebhookRequest 结构体。

参数

• body - 请求体原始字节

返回

解析成功返回 Ok(WebhookRequest)，失败返回错误信息

Requirements

• 9.3: THE Webhook_Trigger SHALL extract message content from request body

pub fn handle_request(&self, body: &[u8], signature: &str) -> WebhookResult

处理 Webhook 请求

验证签名并解析请求体，返回处理结果。

参数

• body - 请求体原始字节
• signature - 请求头中的签名

返回

返回 WebhookResult 表示处理结果

Requirements

• 9.1: THE Webhook_Trigger SHALL validate request signature using secret
• 9.2: WHEN signature validation fails, THE Webhook_Trigger SHALL reject the request
• 9.3: THE Webhook_Trigger SHALL extract message content from request body
• 9.5: THE Webhook_Trigger SHALL return trigger result in response

pub fn compute_signature(&self, payload: &[u8]) -> String

计算 payload 的签名

用于生成测试签名或客户端签名。

参数

• payload - 要签名的数据

返回

返回 hex 编码的签名字符串

Trait Implementations

impl Clone for WebhookHandler

fn clone(&self) -> WebhookHandler

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WebhookHandler

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

Formats the value using the given formatter.