取消队列任务¶
来源同步:
/Users/mac/Projects/chatgpt-codex/doc/api_Screener.md所属接口集:
股票筛选
请求 URL¶
POST /v1/api/screener/queue/cancel
认证方式¶
Bearer Token(详见 认证与签名)
接口概述¶
取消未完成的异步选股任务。已完成的任务无法取消。
请求参数¶
Body 参数(JSON):
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| job_id | string | 是 | - | 队列任务 ID |
接口说明¶
- 只能取消状态为
queued或running的任务。 - 已完成(
done)、已失败(failed)或已取消(canceled)的任务返回HTTP 409。
响应格式示例¶
取消成功(HTTP 200):
冲突(HTTP 409):
返回状态¶
| 状态码 | 说明 |
|---|---|
| 200 | 成功取消 |
| 401 | 未认证 |
| 403 | 无权限 |
| 404 | 任务不存在 |
| 409 | 冲突(任务已完成或已取消) |