推送状态报告

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

备注：

  • 本功能默认不开启，如果开启请前往数据获取与推送页设置。

  • 所有带+86前缀的号码都会去掉+86

  • 接收到数据后，请从参数sms_status中取值，取到值使用urldecode解码后为实际json格式数据处理成功请返回字符串"SUCCESS"或"0"，其他返回值将被认为是失败。该接口失败重试次数为3次，每次间隔5分钟。

  • 获取数据后，建议根据sid做去重。

HTTP头信息: 

  1. Accept:application/json;charset=utf-8;
  2. Content-Type:application/x-www-form-urlencoded;charset=utf-8;

请求

URL：http://your_receive_url_address

注意：海外服务器地址 us.yunpian.com

访问方式：POST

请求参数

参数名类型是否必须描述
sms_statusstring是经过urlencode编码的数据形式如：sms_status=urlencode(json)

具体详解：

推送的数据格式：

  1. <参数名>=<经过urlencode编码的数据>

例如：

  1. sms_status=urlencode(json)

服务端推送数据形式如下：

  1. curl --data "sms_status=url_encode_json" http://your_receive_url_address

推送json参数

名称类型描述
error_detailstring运营商反馈代码的中文解释，仅供参考
sidlong（64位）短信id，64位整型， 对应Java和C#的long，不可用int解析
uidstring用户自定义id
user_receive_timestring用户接收时间
error_msgstring运营商返回的代码，如："DB:0103"
mobilestring接收手机号
report_statusstring接收状态有:SUCCESS/FAIL，状态值无需引号

其中json示例为：

  1. [
  2.     {
  3.         "error_detail": "接收成功",
  4.         "sid": 9527,
  5.         "uid": null,
  6.         "user_receive_time": "2014-03-17 22:55:21",
  7.         "error_msg": "DELIVRD",
  8.         "mobile": "15205201314",
  9.         "report_status": "SUCCESS"
  10.     },
  11.     {
  12.         "error_detail": "接收成功",
  13.         "sid": 9528,
  14.         "uid": null,
  15.         "user_receive_time": "2014-03-17 22:55:23",
  16.         "error_msg": "DELIVRD",
  17.         "mobile": "15212341234",
  18.         "report_status": "SUCCESS"
  19.     }
  20. ]