# 查询任务

请求URL

GET https://lxapi.lexiangla.com/cgi-bin/v1/jobs/{job_id}

请求头

参数 是否必须 说明
Authorization 接口调用凭证 access_token
值格式:"Bearer access_token"
示例值:"Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJS"

其他说明

事项 说明
权限要求
频率限制 3000次/分钟

参数说明

参数 是否必须 默认值 说明
job_id 要查询的任务ID,只能查询72小时内创建的任务

响应

任务等待开始:

{
    "code": 0,
    "msg": "ok",
    "status": 0
}

任务进行中:

{
    "code": 0,
    "msg": "ok",
    "status": 1
}

任务完成:

{
    "code": 0,
    "msg": "ok",
    "status": 2,
    "data": {
        "download_url": "https://xxxxx"
    }
}

参数说明

参数 说明
status 任务状态。0=等待开始,1=任务进行中,2=任务完成
download_url 数据导出任务完成时(status=2),会响应该字段,用于下载文件

重要说明:

  • 任务状态判断:仅当 status=2 时任务才算完成,此时 data.download_url 字段才会返回
  • 任务流程status=0 (等待队列) → status=1 (处理中) → status=2 (完成)
  • 轮询建议:任务未完成时(status=0status=1)应继续轮询,建议间隔 3-5 秒查询一次
  • URL 有效期download_url 一般自当前查询任务响应时间起,5小时内有效,请获取到后尽快下载