文档中心

签名审核结果回调

最近更新时间：2023.01.16 23:06:26

首次发布时间：2023.01.16 23:06:26

您可以在短信服务控制台的回执配置中设置回调 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	int	审核工单ID
account	string	火山主账号
sub_account	string	消息组ID
signature	string	签名内容
audit_result	bool	审核结果 true：审核通过 false：未通过
audit_opinion	string	审核意见，只有 audit_result 为 false 时才有
audit_time	string	审核时间

回调结果示例

审核通过示例

{
  "apply_id": 39701,
  "account": "2100000000",
  "sub_account": "6df86000",
  "signature": "sign",
  "audit_result": true,
  "audit_time": "2022-09-14 11:46:25"
}

审核驳回示例

{
  "apply_id": 39799,
  "account": "2100000000",
  "sub_account": "6df86000",
  "signature": "sign",
  "audit_result": false,
  "audit_opinion": "无法识别签名方信息，请提供相应的证明文件",
  "audit_time": "2022-09-14 11:48:15"
}

返回值

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