取消任务
POST https://maxaeo.cn/geoapi/geodata/developer/task/cancel取消一个还在排队的任务。取消成功的任务 status 为 canceled,不扣点数,提交时预占的点数释放。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
task_id |
string | 是 | 提交任务或任务列表返回的任务 ID,最长 64 个字符 |
请求体只有 task_id 一个字段,多传字段返回 1001。
能操作哪些任务:和查询任务一样,同一用户在个人账户下提交的所有任务,不论用的是哪个 API Key,还是在控制台在线调试提交的。
curl -X POST "https://maxaeo.cn/geoapi/geodata/developer/task/cancel" \ -H "Authorization: Bearer $MAXAEO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"task_id": "task_3f6c1d2e-8a4b-4c1f-9e2d-7b5a0c9d1e23"}'import os
import requests
URL = "https://maxaeo.cn/geoapi/geodata/developer/task/cancel"HEADERS = {"Authorization": f"Bearer {os.environ['MAXAEO_API_KEY']}"}
data = requests.post( URL, headers=HEADERS, json={"task_id": "task_3f6c1d2e-8a4b-4c1f-9e2d-7b5a0c9d1e23"}, timeout=30).json()if data["ret"] != 1: raise RuntimeError(f"ret={data['ret']}: {data['msg']}")
task = data["data"]["ent"]if task["status"] == "canceled": print("已取消")else: print("没有取消,当前状态:", task["status"])const URL = "https://maxaeo.cn/geoapi/geodata/developer/task/cancel";const headers = { Authorization: `Bearer ${process.env.MAXAEO_API_KEY}`, "Content-Type": "application/json",};
const resp = await fetch(URL, { method: "POST", headers, body: JSON.stringify({ task_id: "task_3f6c1d2e-8a4b-4c1f-9e2d-7b5a0c9d1e23" }),});const data = await resp.json();if (data.ret !== 1) throw new Error(`ret=${data.ret}: ${data.msg}`);
const task = data.data.ent;console.log(task.status === "canceled" ? "已取消" : `没有取消,当前状态:${task.status}`);data.ent 是任务对象,和查询任务同结构。按返回的 status 判断结果:
status |
含义 | 点数 |
|---|---|---|
canceled |
取消成功 | 不扣,预占的点数释放 |
running |
任务已经开始,没有取消,照常跑完 | 成功照常扣点 |
succeeded / failed |
任务已经结束,没有取消 | 按任务本身的结果 |
queued、pending的任务可以取消。dispatching(交接中)的任务可能暂时取消不了,会原样返回,稍后再调一次;少数情况下pending的任务也会这样。只要status不是canceled,就是没取消成功。- 没取消成功不是错误,
ret仍是1,所以一定要看status。 - 重复调用不报错,可以放心再调。
取消成功的响应示例:
{ "ret": 1, "data": { "ent": { "thinking": false, "task_id": "task_3f6c1d2e-8a4b-4c1f-9e2d-7b5a0c9d1e23", "platform": "doubao", "query": "适合程序员的机械键盘推荐", "status": "canceled", "answer": "", "result_json": "", "share_link": "", "error_code": "crawl_canceled", "error_message": "任务已取消", "started_at": 0, "finished_at": 1793018460, "created_at": 1793018425, "updated_at": 1793018460, "monitor_date": "2026-10-26", "priority": 2, "country": "", "credits": 0 } }}已取消的任务 error_code 为 crawl_canceled,error_message 是纯文本「任务已取消」,credits 为 0。
已取消的任务不能重试(对它调用重试会原样返回 canceled)。需要重新跑,请重新提交,会得到新的 task_id;task_id 由服务端生成,不能指定。
ret |
原因 |
|---|---|
1001 |
task_id 缺失或超过 64 个字符,或请求体含未定义的字段 |
1030 |
API Key 缺失或无效 |
1031 |
任务不存在,或不属于当前用户 |
-1 |
服务暂时不可用,任务保持原样,可以再调一次 |
