获取状态报告

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

备注：

  • 该接口为高级接口，默认不开放，可以在云片用户后台开启。

  • 建议使用单线程获取。获取数据后，建议根据sid做去重。

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/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，状态值无需引号

Json响应示例：

  1. [
  2.     {
  3.         "error_detail": "接收成功",
  4.         "sid": 25116408942,
  5.         "uid": "123",
  6.         "user_receive_time": "2018-06-19 14:22:17",
  7.         "error_msg": "DELIVRD",
  8.         "mobile": "13735877801",
  9.         "report_status": "SUCCESS"
  10.     }
  11. ]