腾讯云短信

Feature: sms-tencent

📖 官方文档：https://cloud.tencent.com/document/product/382/55981

纯 Rust 实现，通过腾讯云 SMS API 直接发送短信，不依赖第三方 SDK。

config.toml 配置

[sms_tencent]
secret_id = "your-secret-id"
secret_key = "your-secret-key"
sdk_app_id = "1400000000"    # 短信 SdkAppId
sign_name = "你的签名"        # 默认短信签名
template_id = "123456"        # 默认验证码模板 ID

API

SmsTencent

TencentSmsResponse

SendStatus

使用示例

#![allow(unused)]
fn main() {
// 发送验证码（使用 config.toml 中的默认签名和模板）
let resp = state.sms_tencent.send_code("13800138000", "1234", Some("5")).await?;

// 发送自定义模板
let resp = state
    .sms_tencent
    .send_template(
        &["13800138000"],
        "你的签名",
        "123456",
        vec!["张三", "20250101"],
    )
    .await?;

// 批量发送
let resp = state
    .sms_tencent
    .send(
        &["13800138000", "13900139000"],
        None,
        None,
        Some(vec!["5678"]),
    )
    .await?;
}

签名机制

使用腾讯云 TC3-HMAC-SHA256 签名，纯 Rust 实现。与 COS 模块使用相同的签名模式。

回执回调

启用 sms-tencent feature 后，框架会自动在 config.toml 中 sms_tencent.callback_path（默认 sms/tencent/report）注册 POST 路由，用于接收腾讯云推送的短信回执报告。

配置

[sms_tencent]
callback_path = "sms/tencent/report"  # 可选，默认值如左

注册回调

#![allow(unused)]
fn main() {
use afaster::SmsTencent;
use afaster::state::smstencent::{TencentSmsReport, TencentSmsCallbackResult};

let app = AFaster::new()
    .with_sms_tencent(|tencent| {
        tencent.with_report_callback(|(state, reports): (AppState, Vec<TencentSmsReport>)| {
            async move {
                for report in reports {
                    if report.report_status == "SUCCESS" {
                        tracing::info!(phone = %report.mobile, "短信送达");
                    } else {
                        tracing::warn!(phone = %report.mobile, err = %report.errmsg, "短信未送达");
                    }
                }
                Ok(TencentSmsCallbackResult::ok())
            }
        })
    })
    .run()
    .await;
}

注意：未注册回调时，回执报告会被静默丢弃并返回成功（避免云平台重试），开启 log feature 会打印 debug 日志。

TencentSmsReport 字段

错误码