查询队列任务状态

来源同步：/Users/mac/Projects/chatgpt-codex/doc/api_Screener.md

所属接口集：股票筛选

请求 URL

GET /v1/api/screener/queue/status

认证方式

Bearer Token（详见 认证与签名）

接口概述

查询异步选股任务的当前状态和进度。

请求参数

Query 参数：

参数	类型	必填	默认值	说明
job_id	string	是	-	队列任务 ID

接口说明

• 返回任务当前状态：queued、running、done、failed、canceled。
• progress 包含进度详情：pct（百分比）、step（当前步骤）、note（备注）。

响应格式示例

{
  "code": 1,
  "message": "ok",
  "data": {
    "job_id": "abc123",
    "status": "running",
    "progress": {
      "pct": 25,
      "step": "fetch",
      "note": ""
    }
  }
}

返回状态

状态码	说明
200	成功
401	未认证
403	无权限
404	任务不存在

---