taobao.top.kitcode.history.query (套件历史扫描任务查询)

套件历史扫描任务查询,任务为异步执行,任务执行完成代表着时间范围内的数据均已重新触发一次

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
task_id Number 必须 1 任务ID
kit_code String 必须 topxp 套件名称

响应参数

名称 类型 示例值 描述
result ScanTaskVo {} 系统自动生成
  • └ end
  • Date
  • 2021-07-15 16:41:59
  • 截止时间
  • └ create
  • Date
  • 2021-07-15 16:42:06
  • 创建时间
  • └ task_id
  • Number
  • 1
  • 任务编码
  • └ kit_code
  • String
  • topxp
  • 套件名称
  • └ now_sync_time
  • Date
  • 2021-07-19 18:28:10
  • 当前已同步时间
  • └ start
  • Date
  • 2021-07-15 16:42:33
  • 开始时间
  • └ status
  • Number
  • 1
  • 任务状态,0代表执行中,2代表执行完成,-1代表取消
  • └ scan_count
  • Number
  • 200
  • 当任务状态为2时,展示当前任务总推送次数,数据量较大时存在分钟级滞后性更新;注意仅7天内有效;极小概率会有少量误差

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TopKitcodeHistoryQueryRequest req = new TopKitcodeHistoryQueryRequest();
req.setTaskId(1L);
req.setKitCode("topxp");
TopKitcodeHistoryQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<top_kitcode_history_query_response>
    <result>
        <end>2021-07-15 16:41:59</end>
        <create>2021-07-15 16:42:06</create>
        <task_id>1</task_id>
        <kit_code>topxp</kit_code>
        <now_sync_time>2021-07-19 18:28:10</now_sync_time>
        <start>2021-07-15 16:42:33</start>
        <status>1</status>
        <scan_count>200</scan_count>
    </result>
</top_kitcode_history_query_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部