获取状态报告
功能说明:
开通此接口功能后,我们将为您独立再保存一份新生产的状态报告数据,保存时间为 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
请求参数
接口说明
参数名 | 类型 | 是否必须 | 描述 | 示例 |
apikey | String | 是 | 用户唯一标识,在"账号设置"-"子帐号管理"中查看 | 9b11127a9701975c734b8aee81ee3526 |
page_size | integer | 否 | 每页个数,最大 100 个,默认 20 个 | 20 |
响应参数
名称 | 类型 | 描述 |
error_detail | string | 运营商反馈代码的中文解释,仅供参考(默认不推送此字段,如需推送,请联系客服开通) |
sid | long(64 位) | 短信 id,64 位整型, 对应 Java 和 C#的 long,不可用 int 解析 |
uid | string | 用户自定义 id |
user_receive_time | string | 用户接收时间 |
error_msg | string | 运营商返回的代码,如:"DB:0103" |
mobile | string | 接收手机号 |
report_status | string | 接收状态有:SUCCESS/FAIL |
###Json 响应示例:
[
{
"error_detail": "接收成功",
"sid": 25116408942,
"uid": "123",
"user_receive_time": "2018-06-19 14:22:17",
"error_msg": "DELIVRD",
"mobile": "13735877801",
"report_status": "SUCCESS"
}
]