状态报告推送接口
功能说明:
开通此接口后,我们将为您实时推送最新的状态报告。您需要提供一个 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_status | string | 是 | 经过 urlencode 编码的数据形式如:voice_status=urlencode(json) |
具体详解:
推送的数据格式:
参数名=经过urlencode编码的数据
形式如:
voice_status=urlencode(json)
服务端推送数据形式如下:
curl --data "voice_status=url_encode_json" http://your_receive_url_address
推送 json 参数
名称 | 类型 | 描述 |
sid | string | 语音记录 id,不超过 32 位的唯一字符串 |
uid | string | 用户自定义 id |
user_receive_time | string | 用户接收时间 |
error_msg | string | 接收失败的原因,如:"Send Exception","用户信号不佳、关机等" |
mobile | string | 接收手机号 |
report_status | string | 接收状态有: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": "3375655611", "uid": null, "user_receive_time": "2020-07-01 14:33:23", "duration": 0, "error_msg": "failed", "mobile": "+37258483726", "report_status": "FAIL" } ]
备注:
接收到数据后,请从参数 voice_status 中取值,取到值使用 urldecode 解码后为实际 json 格式数据(部分语言由于解码方式差异需要解码两次) 处理成功请返回字符串"SUCCESS"或"0",其他返回值将被认为是失败。
该接口失败重试次数为 3 次,每次间隔 5 分钟。