网页解析
查询网页转换任务状态和结果
限时免费
0次调用
提交了URL转Markdown任务后，想知道处理进度和结果？这个接口可以帮你实时追踪。
GET
uapis.cn
/api/v1/web/tomarkdown/async/{task_id}
路径参数
1
task_id
string
required
任务ID（由提交接口返回）
功能概述
通过之前提交任务时获得的任务ID，你可以查询该任务的当前状态、处理进度以及最终结果。任务结果会在缓存中保存30分钟，期间可以重复查询，非常方便。
任务有五种状态：等待处理（pending）时进度为0%；处理中（processing）时进度在10-90%之间；已完成（completed）时进度为100%并返回Markdown内容；失败（failed）时会返回错误信息；超时（timeout）表示任务处理时间超过60秒已被取消。建议采用指数退避策略进行轮询，初始延迟1秒，每次延迟增加20%，最大延迟5秒。当状态为已完成、失败或超时时停止轮询。
系统会自动管理任务生命周期，单个任务最长处理时间为60秒，任务结果保存30分钟后自动清理，每5分钟清理一次过期任务。
任务状态说明
| 状态 | 说明 | 进度 | 轮询建议 |
|---|---|---|---|
pending | 等待处理 | 0% | 立即开始轮询 |
processing | 处理中 | 10-90% | 每2-5秒轮询一次 |
completed | 已完成 | 100% | 停止轮询，获取结果 |
failed | 失败 | 100% | 停止轮询，查看错误信息 |
timeout | 超时 | 100% | 停止轮询，任务已取消 |
路径参数
task_id
stringrequired
任务ID（由提交接口返回）
响应
200 / 请求成功
成功获取任务状态（包含各种状态的响应）
404 / 未找到
任务不存在或已过期