获取短信状态(调用API获取)

请求

URL:https://api.dingdongcloud.com/v2/sms/report/get.json

请求方式:GET/POST (推荐POST)

请求参数

参数名 是否必填 类型 描述 示例
apikey String 账户唯一标识符 fe7e701f21645f35d62b95df8c85493f
ser_no String 短信批次号 201602161456000005

注意事项

  1. 如果ser_no不传,则按照顺序返回状态。
  2. 所有短信状态只能获取一次,如需多次获取,可通过ser_no参数进行获取。
  3. 只能获取2个星期内发送短信的状态。
  4. 如需重新获取状态,请联系客服。

响应

名称 类型 描述 示例
code Integer code为1,表示成功,其他请参考返回值说明 1
msg String 返回结果说明 成功
result Json 状态数据,如果api调用错误,则为null json结果

result中具体字段

名称 类型 描述 示例
mobile String 接收短信的手机号码 18965871298
ser_no String 短信批次号 201602161456000005
status String 接收状态 DELIVRD
send_time Integer 短信提交时间 1569479399770
report_time Integer 用户收到的时间点 1569479415012

JSON响应示例:

{
    "code": 1,
    "msg": "成功",
    "result": [
        {
            "mobile": "13656656411",
            "status": "DELIVRD",
            "send_time": 1569479399770,
            "report_time": 1569479415012,
            "ser_no": "891330703123685376"
        }
    ]
}

系统主动推送短信状态

功能说明: 开通此接口后,我们将为您实时推送最新的状态报告。您需要提供一个url地址,接受http post请求。 该接口一次最多推送100个状态报告,为不影响推送速度,建议先接受数据后再做异步处理。

备注:

  • 该接口为高级接口,默认不开放,可以在用户后台开启并配置。
  • 接收到数据后,请从参数report中取值,取到值使用urldecode解码后为实际json格式数据处理成功请返回字符串"SUCCESS",其他返回值将被认为是失败。该接口失败重试次数为3次,每次间隔5分钟。

请求

URL:您配置的推送地址

请求方式:GET/POST (推荐POST)

请求参数

参数名 是否必填 类型 描述
report String 经过urlencode编码的数据形式如:report=urlencode(json)

推送的JSON具体字段

名称 类型 描述 示例
mobile String 接收短信的手机号码 18965871298
ser_no String 短信批次号 201602161456000005
status String 接收状态 DELIVRD
send_time Integer 短信提交时间 1569479399770
report_time Integer 用户收到的时间点 1569479415012

JSON响应示例:

[
   {
            "mobile": "13656656411",
            "status": "DELIVRD",
            "send_time": 1569479399770,
            "report_time": 1569479415012,
            "ser_no": "891330703123685376"
        }
]

17098409373

常见售前问题:

可以发哪些类型短信?
叮咚云短信的价格?
如何接入叮咚云验证码/通知短信?

》查看更多常见问题《