状态报告获取接口


功能说明:
开通此接口功能后,我们将为您独立再保存一份新生产的状态报告数据,保存时间为 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": "3375655611",
    "uid": null,
    "user_receive_time": "2015-07-01 14:30:09",
    "duration": 0,
    "error_msg": "failed",
    "mobile": "+37258483726",
    "report_status": "FAIL"
  }
]