您可以指定HTTP URL来接收签名审核状态。当签名审核状态变更时,平台会推送签名审核状态详情至您提供的HTTP接收地址,您需要接收消息并按平台要求的固定格式响应。
使用说明
如果需要通过HTTP方式获取短信签名审核状态,请先在短信服务控制台开启签名审核状态消息接收选项,并配置接收地址后才可以获取签名审核状态。回执消息配置详情,请参见回执消息配置。
参数说明
参数内容为JSON Array格式,单次请求仅包含一条签名审核状态报告。
协议说明
参数 | 说明 |
参数 | 说明 |
请求协议 | HTTP |
请求格式 | application/json |
编码 | UTF-8 |
参数示例
[
{
"sign_source": "公众号",
"reason": "test",
"sign_name": "短信签名模版1957",
"orderId": "205100",
"sign_status": "approved",
"remark": "test",
"sign_scene": "SMS_123123242",
"create_date": "2019-05-30 19:58:25"
}
]
字段说明
名称 | 类型 | 是否必选 | 示例值 | 描述 |
名称 | 类型 | 是否必选 | 示例值 | 描述 |
sign_source | String | 是 | 公众号 | 签名来源。 |
reason | String | 是 | test | 审核未通过原因。 |
sign_name | String | 是 | 短信签名模板1957 | 签名名称。 |
orderId | String | 是 | 205100 | 签名审核工单号。 |
sign_status | String | 是 | approved | 签名审核状态,包括:
|
remark | String | 否 | test | 申请说明。 |
sign_scene | String | 是 | SMS_123123242 | 适用场景。 |
create_date | String | 是 | 2019-05-30 19:58:25 | 签名创建日期和时间。 |
响应说明
您提供的HTTP地址在接收到请求参数后,需按以下格式进行响应。
响应示例
{
"code" : 0,
"msg" : "接收成功"
}
字段说明
名称 | 类型 | 是否必选 | 示例值 | 描述 |
名称 | 类型 | 是否必选 | 示例值 | 描述 |
code | Number | 是 | 0 | 应答编码。系统仅校验code是否为数字,不校验内容。 |
msg | String | 否 | 接收成功 | 描述信息。 |
若HTTP状态码为200,则请求成功;HTTP状态码非200或响应超时情况下,系统会重试推送。
若出现系统异常、消费失败等情况,建议HTTP状态码返回50X。
重试推送
第一次推送失败后,间隔1分钟、5分钟、10分钟后会进行重推,直至推送成功为止。如果推送3次后仍失败,不再重试。
报告接收示例
@PostMapping("/resMsg")
public JSONObject resMsg(@RequestBody JSONArray array) {
// TODO:您需要自行处理回执消息,此示例只打印回执信息
System.out.println(array.toJSONString());
JSONObject json = new JSONObject();
json.put("code", 0);
json.put("msg", "接收成功");
return json;
}
- 本页导读 (1)
- 使用说明
- 参数说明
- 协议说明
- 参数示例
- 字段说明
- 响应说明
- 响应示例
- 字段说明
- 重试推送
- 报告接收示例