获取状态报告


功能说明:
开通此接口功能后,我们将为您独立再保存一份新生产的状态报告数据,保存时间为72小时。 您可以通过此接口获取新产生的状态报告。注意,已成功获取的数据将会删除,请妥善处理接口返回的数据。


备注:


  • 该接口为高级接口,默认不开放,可以在云片用户后台开启。
  • 建议使用单线程获取。获取数据后,建议根据sid做去重。


HTTP头信息:


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


请求


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


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


访问方式:POST


请求参数

参数名类型是否必须描述示例
apikeystring

用户唯一标识,在账号设置-子帐号管理中查看

9b11127a9701975c734b8aee81ee3526
page_sizeinteger每页个数,最大100个,默认20个20


响应参数

名称类型描述
error_detailstring运营商反馈代码的中文解释,默认不推送此字段,如需推送,请联系客服;
sidlong(64位)短信id,64位整型, 对应Java和C#的long,不可用int解析
uidstring用户自定义id
user_receive_timestring用户接收时间
error_msgstring运营商返回的代码,如:"DB:0103"
mobilestring接收手机号
report_statusstring接收状态有: "SUCCESS"/ "FAIL"


重要说明


请按照如下顺序使用参数


  1. 请先使用 report_status 判断接收状态;如果是"SUCCESS",为接收成功;如果是"FAIL",为接收失败;
  1. 如果接收状态失败,可以参考error_detail 以及 error_msg 来获取更详细信息;特别注意,这两个字段为解释型字段,请不要依据这两个字段判断接收状态;
  1. 请妥善保存推送信息;
  1. 如果您的系统接收推送信息失败,请及时联系我们。


###Json响应示例


[
    {
        "error_detail": "接收成功",
        "sid": 9527,
        "uid": "1234567",
        "user_receive_time": "2014-03-17 22:55:21",
        "error_msg": "DELIVRD",
        "mobile": "15205201314",
        "report_status": "SUCCESS"
    },
    {
        "sid": 9528,
        "user_receive_time": "2014-03-17 22:55:23",
        "error_msg": "DELIVRD",
        "mobile": "15212341234",
        "report_status": "SUCCESS"
    },
    {
        "error_detail": "接收成功",
        "sid": 9529,
        "uid": "abcdefg",
        "user_receive_time": "2014-03-17 22:55:23",
        "error_msg": "DELIVRD",
        "mobile": "15212341234",
        "report_status": "SUCCESS"
    }
]