状态报告获取接口
功能说明:开通此接口功能后,我们将为您独立再保存一份新生产的状态报告数据,保存时间为72小时。
您可以通过此接口获取新产生的状态报告。注意,已成功获取的数据将会删除,请妥善处理接口返回的数据。
备注:该接口为高级接口,默认不开放,如有需要请在后台数据推送与获取页面设置开启。
HTTP头信息:
Accept:application/json;charset=utf-8;
Content-Type:application/x-www-form-urlencoded;charset=utf-8;
请求
URL:https://sms.yunpian.com/v2/voice/pull_status.json
注意:海外服务器地址 us.yunpian.com
访问方式:POST
请求参数
参数名 | 类型 | 是否必须 | 描述 | 示例 |
---|---|---|---|---|
apikey | string | 是 | 用户唯一标识 | 9b11127a9701975c734b8aee81ee3526 |
page_size | integer | 否 | 每页个数,最大100个,默认20个 | 20 |
响应
名称 | 类型 | 描述 |
---|---|---|
sid | string | 语音记录id,32位的唯一字符串 |
uid | string | 用户自定义id |
user_receive_time | string | 用户接收时间 |
duration | integer | 通话时长 |
error_msg | string | 接收失败的原因,如:"Send Exception","用户信号不佳、关机等" |
mobile | string | 接收手机号 |
report_status | string | 接收状态有:SUCCESS/FAIL,状态值无需引号 |
Json响应示例:
调用成功的返回值示例:
[
{
"sid": "931ee0bac7494aab8a422fff5c6be3ea",
"uid": null,
"user_receive_time": "2015-07-01 14:29:12",
"duration": 10,
"error_msg": null,
"mobile": "15205201314",
"report_status": "SUCCESS"
},
{
"sid": "821ee0bac7494aab8a422fff5c6be3ea",
"uid": null,
"user_receive_time": "2015-07-01 14:30:09",
"duration": 0,
"error_msg": "用户未应答",
"mobile": "15205201315",
"report_status": "FAIL"
}
]