新版本签名审核结果回调--短信服务-火山引擎

文档中心

立即注册

导航

新版本签名审核结果回调

最近更新时间：2025.11.21 15:21:00首次发布时间：2025.10.14 11:15:49

您可以在短信服务控制台的回执配置中设置回调 URL，用于接收签名的审核结果。签名审核状态从审核中变成已通过或者驳回时推送审核结果，已关闭或者免审状态的签名不会返回审核结果。

注意事项

回调地址需要符合以下条件，才可以成功接收签名的审核结果。

使用 HTTP/HTTPS URL。
短信服务可以直接访问回调地址，即回调地址具备公网访问能力。
如果回调地址所在服务器设置了防火墙，请放行来自短信服务的请求。

准备工作

在您接收短信服务的回调消息之前，需要登录短信服务控制台配置用于接收回调消息的 URL。

登录短信服务控制台。
在左侧导航栏，选择通用管理 > 回执配置。
在回执配置页面，编辑签名审核状态回调地址。
设置您用于接收回调消息的 URL。URL 格式为http(s)://<您的回调地址>。

在短信服务控制台设置回调地址后，当签名审核变为最终状态时，短信服务会异步向回调地址返回签名审核情况。

回调请求说明

当短信服务返回签名审核结果时，会向回调地址发送 POST 请求。本章节介绍请求 Header 和 Body 包含的参数说明。

Header

参数	取值	描述
Content-Type	application/json;charset=utf-8	定义网络文件的类型和网页的编码。
Accept-Encoding	gzip, deflate	采用指定的压缩格式传输数据。
Accept	/	指定客户端希望接收的数据类型。

Body

整体为Json数组。

参数	类型	说明
apply_id	long	审核工单ID，64位长度int
account	string	火山主账号
sub_account	string	消息组ID
signature	string	签名内容
audit_result	bool	审核结果 true：审核通过 false：未通过
audit_opinion	string	审核意见，只有 audit_result 为 false 时才有
audit_time	string	审核时间
industry	string	内容所属行业
channel_type	string	发送类型

回调结果示例

审核通过示例

{
    "apply_id": 4294986642,
    "account": "2100000000",
    "sub_account": "6df86000",
    "signature": "sign",
    "audit_result": true,
    "audit_time": "2022-09-14 11:46:25",
   "channel_type":"CN_NTC,CN_OTP,CN_MKT",
    "industry":"通用"
}

审核驳回示例

{
    "apply_id": 4294986642,
    "account": "2100000000",
    "sub_account": "6df86000",
    "signature": "sign",
    "audit_result": false,
    "audit_time": "2022-09-14 11:46:25",
   "channel_types":"CN_NTC",
    "industry":"物流",
    "audit_opinion": "签名行业有问题，不通过"
}

返回值

要求用户侧接收成功后，返回 httpStatus为200，否则火山侧会认为回调失败。
回调失败不重推。