状态报告推送接口


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


备注:
该接口为高级接口,需要自行在后台设置开启。


HTTP 头信息:


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


请求


URL:http://your_receive_url_address
访问方式:POST


请求参数

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


具体详解:


推送的数据格式:


参数名=经过urlencode编码的数据


形式如:


voice_status=urlencode(json)


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


curl --data "voice_status=url_encode_json" http://your_receive_url_address


推送 json 参数

名称类型描述
sidstring语音记录 id,32 位的唯一字符串
uidstring用户自定义 id
user_receive_timestring用户接收时间
error_msgstring接收失败的原因,如:"Send Exception","用户信号不佳、关机等"
mobilestring接收手机号
report_statusstring接收状态有:SUCCESS/FAIL,状态值无需引号


其中 json 示例为:


[
  {
    "sid": "6e77feeab89f445387308db604e2ec8d",
    "uid": null,
    "user_receive_time": "2015-07-01 14:29:12",
    "duration": 10,
    "error_msg": null,
    "mobile": "15205201314",
    "report_status": "SUCCESS"
  },
  {
    "sid": "302e7fd51f6748cfa70a6fc6aea44c9f",
    "uid": null,
    "user_receive_time": "2015-07-01 14:33:23",
    "duration": 0,
    "error_msg": "用户未应答",
    "mobile": "15205201315",
    "report_status": "FAIL"
  }
]


备注:


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