状态报告推送接口

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

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

请求

URL:http://your_receive_url_address

访问方式:POST

请求参数

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

具体详解:

推送的数据格式:

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

形式如:

sms_status=urlencode(json)

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

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

推送json参数

名称 类型 描述
sid string 语音记录id,32位的唯一字符串
uid string 用户自定义id
user_receive_time string 用户接收时间
error_msg string 接收失败的原因,如:"用户未应答"
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": "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分钟。

results matching ""

    No results matching ""