死链检测 API

检测网页中的死链

GET /api/links/check

请求参数

• url（必填）：网页地址（http / https），只允许公网地址，示例 https://example.com
• limit：最多检测的链接数，1~50（按页面中出现的顺序取前 limit 个），示例 20

返回字段

• url（string）：实际抓取的网页地址（跟随最多 3 次跳转后的地址）
• found（number）：页面中找到的 http / https 链接数（已去掉 # 片段并去重）
• summary（object）：汇总；total = ok + dead + skipped
• summary.total（number）：实际检测的链接数（found 与 limit 中较小的一个）
• summary.ok（number）：正常的链接数（状态码 < 400）
• summary.dead（number）：死链数（4xx、5xx 或连接失败 / 超时）
• summary.skipped（number）：跳过的链接数（指向内网或保留地址，未访问）
• links（array）：每个链接的检测结果，顺序与页面中出现的顺序一致
• links[].url（string）：链接的绝对地址（按 <base href> 或页面地址补全，已去掉 # 片段）
• links[].text（string）：锚文本（去掉标签、合并空白，最多 100 字；没有文字时取 title 或图片 alt；都没有时为空字符串）
• links[].status（number|null）：最终的 HTTP 状态码（跟随跳转后）；连接失败、超时或跳过时为 null
• links[].statusText（string|null）：状态码的中文说明（如 404 未找到）；status 为 null 时为 null
• links[].ok（boolean）：是否正常（状态码 < 400）
• links[].dead（boolean）：是否死链：状态码 ≥ 400，或连接失败、超时
• links[].skipped（boolean）：是否跳过：链接或其跳转目标指向内网 / 保留地址时不访问，标记为跳过（既不算正常也不算死链）
• links[].error（string|null）：问题说明：死链为"HTTP 404 未找到"或连接失败原因（如"连接超时""域名无法解析"），跳过时为跳过原因；正常时为 null
• links[].finalUrl（string|null）：发生跳转时的最终地址；没有跳转、失败或跳过时为 null
• links[].ms（number）：检测该链接的耗时（毫秒，保留两位小数，含跳转；单个链接最多 5 秒）