跳转至

取消队列任务

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

所属接口集:股票筛选

请求 URL

POST /v1/api/screener/queue/cancel

认证方式

Bearer Token(详见 认证与签名

接口概述

取消未完成的异步选股任务。已完成的任务无法取消。

请求参数

Body 参数(JSON):

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

接口说明

  • 只能取消状态为 queuedrunning 的任务。
  • 已完成(done)、已失败(failed)或已取消(canceled)的任务返回 HTTP 409

响应格式示例

取消成功(HTTP 200):

{
  "code": 1,
  "message": "canceled",
  "data": {
    "job_id": "abc123",
    "status": "canceled"
  }
}

冲突(HTTP 409):

{
  "code": 0,
  "message": "conflict"
}

返回状态

状态码 说明
200 成功取消
401 未认证
403 无权限
404 任务不存在
409 冲突(任务已完成或已取消)