微信内容安全

Feature: wx-sec-check

📖 官方文档：https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/sec-check/security.msgSecCheck.html

配置

[wx_sec_check]
app_id     = "wx1234567890"
app_secret = "your-secret"
# base_url = "https://api.weixin.qq.com"  # 可选，默认值

API

WxSecCheck

MsgSecCheckRequest

#![allow(unused)]
fn main() {
// Builder 模式构造
let request = MsgSecCheckRequest::new(
    "待检测文本",       // content: &str
    Scene::Comment,     // scene: Scene
    "user_openid",      // openid: &str
)
.title("标题")         // 可选
.nickname("昵称")      // 可选
.signature("签名");    // 可选，仅 scene=Profile 有效
}

MsgSecCheckResponse

#![allow(unused)]
fn main() {
pub struct MsgSecCheckResponse {
    pub errcode: Option<i32>,
    pub errmsg: Option<String>,
    pub trace_id: Option<String>,
    pub result: Option<SecCheckResult>,     // 综合结果
    pub detail: Option<Vec<SecCheckDetail>>,// 详细检测结果
}
}

MediaCheckRequest

#![allow(unused)]
fn main() {
let request = MediaCheckRequest::new(
    "https://example.com/image.jpg",  // media_url
    MediaType::Image,                  // media_type: 1=音频, 2=图片
    Scene::Comment,                    // scene
    "user_openid",                     // openid
);
}

异步检测结果会在 30 分钟内推送到消息接收服务器，推送事件为 wxa_media_check。 文件大小限制 10MB。

场景枚举 (Scene)

建议枚举 (Suggest)

标签枚举 (Label)

媒体类型 (MediaType)

错误码

使用示例

文本检测

#![allow(unused)]
fn main() {
use afaster::state::wx_sec_check::{MsgSecCheckRequest, Scene};

let request = MsgSecCheckRequest::new(
    "待检测的文本内容",
    Scene::Comment,
    "user_openid",
);

let response = state.wx_sec_check.msg_sec_check(&request).await?;

if let Some(result) = &response.result {
    match result.suggest.as_str() {
        "risky" => println!("拦截: label={}", result.label),
        "review" => println!("需审核: label={}", result.label),
        "pass" => println!("通过"),
        _ => {}
    }
}
}

媒体检测

#![allow(unused)]
fn main() {
use afaster::state::wx_sec_check::{MediaCheckRequest, MediaType, Scene};

let request = MediaCheckRequest::new(
    "https://example.com/image.jpg",
    MediaType::Image,
    Scene::Comment,
    "user_openid",
);

let response = state.wx_sec_check.media_check_async(&request).await?;
println!("trace_id: {:?}", response.trace_id);
}

注册媒体检测回调

统一通知模块：媒体检测结果由 wx-notify 模块统一接收和分发。 微信后台只需配置一个回调 URL（默认 https://your-domain/wx/notify）， 后端通过 Event 字段自动路由到 wxa_media_check 回调。

详细配置参见 config.toml 中的 [wx_notify] 段。

#![allow(unused)]
fn main() {
use afaster::AFaster;

AFaster::new()
    .with_wx_notify(|w| {
        w.with_media_check_callback(|(state, notify)| {
            async move {
                // 处理异步检测结果
                if let Some(result) = &notify.result {
                    println!("检测结果: {:?}", result.suggest);
                }
                if let Some(detail) = &notify.detail {
                    for item in detail {
                        println!("策略: {}, 建议: {}, 标签: {}", item.strategy, item.suggest, item.label);
                    }
                }
                Ok(WxSecCheckNotifyResult::success())
            }
        })
    })
    .run()
    .await;
}

注意：未注册回调时，wx-notify 模块返回错误码 50815，微信会重试最多 15 次。