重试任务
POST https://maxaeo.cn/geoapi/geodata/developer/task/retry重试一个抓取失败的任务。任务保持原来的 task_id 回到排队,重新执行;成功才扣点数,按提交时的单价,只扣一次。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
task_id |
string | 是 | 提交任务或任务列表返回的任务 ID,最长 64 个字符 |
请求体只有 task_id 一个字段,多传字段返回 1001。能操作哪些任务的规则同取消任务。
哪些任务能重试
Section titled “哪些任务能重试”只有同时满足下面三条的任务能重试:
status为failed;error_code为crawl_failed(平台抓取失败);- 提交不超过 7 天。
其他失败(如提交被拒绝、API Key 失效)返回 1032,请重新提交。极少数情况下,满足这三条的任务也可能因为平台侧已查不到而返回 1032,同样重新提交。已取消的任务也不能重试。
未结束、已成功、已取消的任务调用重试,会原样返回,不报错。所以重试的响应丢了,直接再调一次也安全。
curl -X POST "https://maxaeo.cn/geoapi/geodata/developer/task/retry" \ -H "Authorization: Bearer $MAXAEO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"task_id": "task_9b2e4f60-1c3d-4e8a-b7f5-2d6c8a0e4b19"}'import os
import requests
URL = "https://maxaeo.cn/geoapi/geodata/developer/task/retry"HEADERS = {"Authorization": f"Bearer {os.environ['MAXAEO_API_KEY']}"}
data = requests.post( URL, headers=HEADERS, json={"task_id": "task_9b2e4f60-1c3d-4e8a-b7f5-2d6c8a0e4b19"}, timeout=30).json()if data["ret"] == 1032: print("这个任务不能重试,请重新提交")elif data["ret"] != 1: raise RuntimeError(f"ret={data['ret']}: {data['msg']}")else: task = data["data"]["ent"] print(task["status"], task["error_code"]) # pending / running / dispatching,之后继续轮询const URL = "https://maxaeo.cn/geoapi/geodata/developer/task/retry";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_9b2e4f60-1c3d-4e8a-b7f5-2d6c8a0e4b19" }),});const data = await resp.json();if (data.ret === 1032) { console.log("这个任务不能重试,请重新提交");} else if (data.ret !== 1) { throw new Error(`ret=${data.ret}: ${data.msg}`);} else { const task = data.data.ent; console.log(task.status, task.error_code); // pending / running / dispatching,之后继续轮询}重试成功时,status 通常是 pending、running 或 dispatching,之后继续按查询任务轮询即可。如果上一次重试其实已经跑完(比如上次的响应丢了),可能直接返回 succeeded。一律以返回的 status 为准。
task_id、created_at、monitor_date和提交时的单价都不变;旧的回答和错误清空。dispatching时error_code是retry_uncertain,表示重试确认中,通常不到 1 秒,不是失败,继续轮询。此时error_message等字段可能还是上次失败的内容,以status为准。
响应示例:
{ "ret": 1, "data": { "ent": { "thinking": false, "task_id": "task_9b2e4f60-1c3d-4e8a-b7f5-2d6c8a0e4b19", "platform": "deepseek", "query": "跑步新手应该怎么选第一双跑鞋?", "status": "pending", "answer": "", "result_json": "", "share_link": "", "error_code": "", "error_message": "", "started_at": 0, "finished_at": 0, "created_at": 1793006882, "updated_at": 1793093300, "monitor_date": "2026-10-26", "priority": 2, "country": "", "credits": 3 } }}重试要重新预占点数,和提交一样可能被拒绝:1022(计费未开通)、1023(余额不足)、1024(待派发或执行中的任务数达上限)、1025(提交过于频繁)、1029(平台不支持或维护中)。
成功才扣点数,按提交时的单价,只扣一次;重试后再失败不扣。见计费与点数。
ret |
原因 |
|---|---|
1001 |
task_id 缺失或超过 64 个字符,或请求体含未定义的字段 |
1030 |
API Key 缺失或无效 |
1031 |
任务不存在,或不属于当前用户 |
1032 |
任务不能重试,请重新提交 |
1022 / 1023 / 1024 / 1025 / 1029 |
重新预占点数时被拒绝,含义同提交任务 |
-1 |
服务暂时不可用,任务保持原样,可以再调一次 |
