• 状态报告推送接口
    • 请求
    • 请求参数
    • 推送json参数
    • 其中json示例为：

    状态报告推送接口

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

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

    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

    访问方式：POST

    请求参数

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

    具体详解：

    推送的数据格式：

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

    形式如：

    1. voice_status=urlencode(json)

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

    1. 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示例为：

    1. [
    2.     {
    3.         "sid": "6e77feeab89f445387308db604e2ec8d",
    4.         "uid": null,
    5.         "user_receive_time": "2015-07-01 14:29:12",
    6.         "duration": 10,
    7.         "error_msg": null,
    8.         "mobile": "15205201314",
    9.         "report_status": "SUCCESS"
    10.     },
    11.     {
    12.         "sid": "302e7fd51f6748cfa70a6fc6aea44c9f",
    13.         "uid": null,
    14.         "user_receive_time": "2015-07-01 14:33:23",
    15.         "duration": 0,
    16.         "error_msg": "用户未应答",
    17.         "mobile": "15205201315",
    18.         "report_status": "FAIL"
    19.     }
    20. ]

    备注：

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