SignSmsReport

更新时间:2025-01-24 09:50:50

您可以指定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

签名审核状态,包括:

  • approving:审核中。

  • approved:审核通过。

  • rejected:审核未通过。

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)
  • 使用说明
  • 参数说明
  • 协议说明
  • 参数示例
  • 字段说明
  • 响应说明
  • 响应示例
  • 字段说明
  • 重试推送
  • 报告接收示例

点击开启售前

在线咨询服务