网页解析

网页转 Markdown

0次调用
4 积分/次

想把一个网页的内容转成干净的 Markdown 文本?这个异步接口可以帮你搞定,特别适合处理大型或复杂的网页。

POST
uapis.cn
/api/v1/web/tomarkdown/async
查询参数
1
url
string
required

需要转换的网页URL。URL必须经过编码。

功能概述

提交一个网页 URL,我们会自动抓取主体内容,剔除广告、导航栏等干扰元素,并转换为 Markdown 格式。同时会提取标题、作者、发布日期等元数据,生成 YAML Front Matter。

任务提交后会立即返回任务 ID,你可以用它来查询处理进度和结果。单个任务最长处理 60 秒,结果缓存 30 分钟。

查询参数

url
string必填

需要转换的网页URL。URL必须经过编码。

响应

202 / 已接受

任务已提交成功,返回任务ID

JSON
{
  // 任务唯一标识符
  "task_id": "a1b2c3d4-e5f6-47a8-b9c0-d1e2f3a4b5c6",
  // 任务状态
  "status": "pending",
  // 要转换的URL
  "url": "https://example.com",
  // 任务创建时间(ISO 8601格式)
  "created_at": "2025-10-13T10:30:45.123456Z",
  // 提示信息
  "message": "任务已提交,请使用task_id查询结果"
}

400 / 错误的请求

请求参数错误

JSON
{
  "error": "缺少参数",
  "message": "url 参数是必需的",
  "code": 400
}