C/2/search/statuses/historical/check
search/statuses/historical/check
查看检索历史数据任务的执行状态。
URL
https://c.api.weibo.com/2/search/statuses/historical/check.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
请求所有商业接口:
- 50000次/小时/IP;
- 50000次/小时/IP;
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | false | string | 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。 |
access_token | false | string | 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。 |
task_id | true | int | 检索历史数据任务ID。 |
timestamp | true | timestamp | 调用方服务器当前时间的UNIX时间戳。 |
signature | true | string | 认证签名。加密方式为signature = md5(id + secret_key + timestamp)。id为任务创建者ID,id,secret_key平台方通过task_id得到。 |
注意事项
- 每个下载任务(task_id)7天后自动过期,过期后,再调该接口返回相应错误信息;
返回结果
JSON示例
//成功返回 { "id": "3567122345", //任务创建者ID "q": "昆明暴力事件,三元食品", "ids": "324344545~12121343~789078912", "province": "11", "city": "5", "starttime": "1389628800", "endtime": "1389690595", "type": , "hasv": , "onlynum": 80, "task_id": "100", //任务ID "status": true, //任务执行状态 "count": 10000 //任务结果条数,当status为false时,该字段返回0 } //失败返回 { "request": "/aim/campaign/create.json", "error_code": 2111XX, "error": "error information." //显示错误信息 }
关于错误返回值与错误代码,参见 错误代码说明
字段说明
无
其他
无