• 状态报告获取接口
    • 请求
    • 请求参数
    • 响应
    • Json响应示例:

    状态报告获取接口

    功能说明:开通此接口功能后,我们将为您独立再保存一份新生产的状态报告数据,保存时间为72小时。

    您可以通过此接口获取新产生的状态报告。注意,已成功获取的数据将会删除,请妥善处理接口返回的数据。

    备注:该接口为高级接口,默认不开放,如有需要请在后台数据推送与获取页面设置开启。

    HTTP头信息:

    1. Accept:application/json;charset=utf-8;
    2. Content-Type:application/x-www-form-urlencoded;charset=utf-8;

    请求

    URL:https://sms.yunpian.com/v2/voice/pull_status.json

    注意:海外服务器地址 us.yunpian.com

    访问方式:POST

    请求参数

    参数名类型是否必须描述示例
    apikeystring用户唯一标识9b11127a9701975c734b8aee81ee3526
    page_sizeinteger每页个数,最大100个,默认20个20

    响应

    名称类型描述
    sidstring语音记录id,32位的唯一字符串
    uidstring用户自定义id
    user_receive_timestring用户接收时间
    durationinteger通话时长
    error_msgstring接收失败的原因,如:"Send Exception","用户信号不佳、关机等"
    mobilestring接收手机号
    report_statusstring接收状态有:SUCCESS/FAIL,状态值无需引号

    Json响应示例:

    调用成功的返回值示例:

    1. [
    2. {
    3. "sid": "931ee0bac7494aab8a422fff5c6be3ea",
    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": "821ee0bac7494aab8a422fff5c6be3ea",
    13. "uid": null,
    14. "user_receive_time": "2015-07-01 14:30:09",
    15. "duration": 0,
    16. "error_msg": "用户未应答",
    17. "mobile": "15205201315",
    18. "report_status": "FAIL"
    19. }
    20. ]