⚠️ 注意 / Note

• 本接口不计费。 响应 JSON 中的 message / message_zh 是全局默认文案 （「本次请求将被计费」），对本接口不适用，请忽略。

• 有 RPS 限流，请按每秒 1 次的频率轮询。 超出路由限流会返回 429 （响应头 Retry-After: 1）；限流按「用户 + 路由」单独计算。

• This endpoint is free of charge. The message / message_zh fields in the response JSON carry a global default notice ("this request will incur a charge") that does not apply here — please ignore them.

• This endpoint is rate limited — poll at no more than 1 request per second. Exceeding the route's limit returns 429 with a Retry-After: 1 header. The limit is tracked per user per route.

[中文]

用途:

• 查询异步任务的执行状态。本端点不计费，三个创建任务端点通用。
• ready 为 true 时即可调用 /async/get_task_result 取回数据。
• 若只关心结果，也可以直接轮询 /async/get_task_result：未就绪时它会 返回 ready = false，不必先查状态。

参数:

• task_id: 创建任务时返回的 task_id（形如 sd_xxxxxxxxxxxxxxxxxx）。

返回:

• task_id: 任务 id； ready: 结果是否已就绪（布尔值）； status: 任务状态（如 starting / running / ready / failed）； record_count: 已抓取到的记录数（就绪后出现）； error_count: 抓取失败的记录数（就绪后出现）； running_time: 已运行时长（毫秒，运行中出现）； collection_duration: 总采集耗时（毫秒，就绪后出现）。
• task_id 格式非法、不存在或已过期（超过 30 天）时返回 400。

[English]

Purpose:

• Check the status of an async task. This endpoint is free and is shared by all three task-creation endpoints.
• Once ready is true, call /async/get_task_result to fetch the data.
• If you only care about the data, you may poll /async/get_task_result directly: it returns ready = false while the task is still running, so checking the status first is optional.

Parameters:

• task_id: The task_id returned on creation (looks like sd_xxxxxxxxxxxxxxxxxx).

Returns:

• task_id: the task id; ready: whether the result is ready (boolean); status: task status (e.g. starting / running / ready / failed); record_count: number of records scraped (present once ready); error_count: number of failed records (present once ready); running_time: elapsed time in ms (present while running); collection_duration: total collection time in ms (present once ready).
• Returns 400 if the task_id is malformed, does not exist, or has expired (over 30 days).

[示例/Example]

task_id = "sd_mvt2xl972bp4a77ncc"