You need to enable JavaScript to run this app.
导航
签名审核结果回调
最近更新时间:2023.01.16 23:06:26首次发布时间:2023.01.16 23:06:26

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

注意事项

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

  • 使用 HTTP/HTTPS URL。

  • 短信服务可以直接访问回调地址,即回调地址具备公网访问能力。

  • 如果回调地址所在服务器设置了防火墙,请放行来自短信服务的请求。

准备工作

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

  1. 登录短信服务控制台

  2. 在左侧导航栏,选择通用管理 > 回执配置

  3. 回执配置页面,编辑签名审核状态回调地址。

    设置您用于接收回调消息的 URL。URL 格式为http(s)://<您的回调地址>


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

回调请求说明

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

Header

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

Body

整体为Json数组。

参数类型说明
apply_idint审核工单ID
accountstring火山主账号
sub_accountstring消息组ID
signaturestring签名内容

audit_result

bool

审核结果

  • true:审核通过

  • false:未通过

audit_opinionstring审核意见,只有 audit_result 为 false 时才有
audit_timestring审核时间

回调结果示例

审核通过示例

{
  "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,否则火山侧会认为回调失败。
回调失败不重推。