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;

请求参数

  必选 类型及范围 说明
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天后自动过期,过期后,再调该接口返回相应错误信息;
  • 每个下载任务的执行时间正常不超过48小时,如果执行超时,可以联系我们优先执行;

返回结果

JSON示例

//成功返回
{
    "id": "3567122345",             //任务创建者ID
    "q": "昆明暴力事件,三元食品",
    "ids": "324344545~12121343~789078912",
    "province": "11",
    "city": "5",
    "starttime": "1389628800",
    "endtime": "1389690595",
    "type": 1,
    "hasv": 1,
    "onlynum": 80,
    "task_id": "100",                 //任务ID
    "status": true,               //任务执行状态,true:完成,false:执行中
    "count": 10000                //任务结果条数,当status为false时,该字段返回0
}
//失败返回
{
    "request": "/aim/campaign/create.json",
    "error_code": 2111XX,
    "error": "error information."               //显示错误信息  
}


关于错误返回值与错误代码,参见 错误代码说明

字段说明

其他



Language: [[{{{2/uri}}}|中文]]


文档更新时间: 2016-03-04
api评价