提交了网页转 Markdown 任务后，想知道处理进度和结果？用这个接口来查询。
任务ID（由提交接口返回）
通过任务 ID 查询转换任务的当前状态、处理进度和最终结果。任务结果缓存 30 分钟，期间可重复查询。
| 状态 | 说明 |
|---|---|
pending | 等待处理 |
processing | 处理中 |
completed | 已完成，可获取结果 |
failed | 失败 |
timeout | 超时（超过 60 秒） |
建议每 2-5 秒轮询一次，当状态为completed、failed 或 timeout 时停止轮询。
task_id任务ID（由提交接口返回）
成功获取任务状态（包含各种状态的响应）
{
"task_id": "a1b2c3d4-e5f6-47a8-b9c0-d1e2f3a4b5c6",
"status": "pending",
"url": "https://example.com",
"progress": 0,
"created_at": "2025-10-13T10:30:45.123456Z",
"message": "任务等待处理"
}{
"task_id": "a1b2c3d4-e5f6-47a8-b9c0-d1e2f3a4b5c6",
"status": "processing",
"url": "https://example.com",
"progress": 50,
"created_at": "2025-10-13T10:30:45.123456Z",
"started_at": "2025-10-13T10:30:46.000000Z",
"elapsed": 2.5,
"message": "任务处理中，请继续轮询"
}{
"task_id": "a1b2c3d4-e5f6-47a8-b9c0-d1e2f3a4b5c6",
"status": "completed",
"url": "https://example.com",
"progress": 100,
"created_at": "2025-10-13T10:30:45.123456Z",
"started_at": "2025-10-13T10:30:46.000000Z",
"completed_at": "2025-10-13T10:30:48.500000Z",
"duration": 2.5,
"result": {
"markdown": "---\ntitle: \"示例页面\"\nauthor: \"作者名\"\n---\n\n# 示例页面\n\n这是转换后的Markdown内容...",
"size": 1234
}
}{
"task_id": "a1b2c3d4-e5f6-47a8-b9c0-d1e2f3a4b5c6",
"status": "failed",
"url": "https://example.com",
"progress": 100,
"created_at": "2025-10-13T10:30:45.123456Z",
"started_at": "2025-10-13T10:30:46.000000Z",
"completed_at": "2025-10-13T10:30:48.000000Z",
"duration": 2,
"error": "网络连接失败: connection timeout"
}任务不存在或已过期
{
"error": "任务不存在",
"message": "未找到指定的task_id，任务可能已过期（30分钟TTL）",
"code": 404
}选择你的语言查看调用示例
curl 'https://uapis.cn/api/v1/web/tomarkdown/async/{task_id}?task_id=a1b2c3d4-e5f6-47a8-b9c0-d1e2f3a4b5c6'转换任务状态API 遵循我们的标准使用政策。具体的调用频率限制和参数要求请参考上方的接口文档。如有特殊需求，请与我们联系。
无需注册即可使用访客积分调用接口。如果您需要更多积分或想要管理自己的调用记录，可以免费注册账号。注册后您将获得更多免费积分，并可以在控制台查看详细的使用情况。
我们的API基于标准的HTTP协议和RESTful设计，理论上支持任何可以发送网络请求的编程语言，包括但不限于 JavaScript (Node.js, Vue, React), Python, Java, PHP, Go, C# 等。它们非常适合用于Web开发、移动APP后端、小程序云函数、自动化脚本等各种开发场景。