跳转到内容

重试任务

POST https://maxaeo.cn/geoapi/geodata/developer/task/retry

重试一个抓取失败的任务。任务保持原来的 task_id 回到排队,重新执行;成功才扣点数,按提交时的单价,只扣一次。

参数 类型 必填 说明
task_id string 是 提交任务或任务列表返回的任务 ID,最长 64 个字符

请求体只有 task_id 一个字段,多传字段返回 1001。能操作哪些任务的规则同取消任务。

只有同时满足下面三条的任务能重试:

  • status 为 failed;
  • error_code 为 crawl_failed(平台抓取失败);
  • 提交不超过 7 天。

其他失败(如提交被拒绝、API Key 失效)返回 1032,请重新提交。极少数情况下,满足这三条的任务也可能因为平台侧已查不到而返回 1032,同样重新提交。已取消的任务也不能重试。

未结束、已成功、已取消的任务调用重试,会原样返回,不报错。所以重试的响应丢了,直接再调一次也安全。

Terminal window
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"}'

data.ent 是任务对象,和查询任务同结构。

重试成功时,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 服务暂时不可用,任务保持原样,可以再调一次