法院文书下载器

要解决的问题

收到法院短信里的“文书送达”链接时，浏览器打开是一个 Vue SPA：页面再从内部 JSON API 拉取文书列表，最后去 OSS 预签名地址下载文件。对工程师来说，这个流程多了一个浏览器环节，批量取件或接入自动化时不够直接。

核心能力

该技能复现 SPA 的请求路径，把“打开页面”变成几步 HTTP 调用：

• 从送达链接中解析 qdbh、sdbh、sdsin 三个参数
• 调用 getWsListBySdbhNew 获取文书列表，字段包括 c_wsmc、c_wjgs 和 wjlj
• 下载 wjlj 指向的预签名 OSS 文件，并按 c_wsmc 保存为 PDF
• 用 file 校验文件类型，并反馈法院名称、案号、文书名称与页数

工作流程

1. 提取参数：送达链接形如 https://zxfw.court.gov.cn/zxfw/#/pagesAjkj/app/wssd/index?qdbh=&sdbh=&sdsin=，三个参数都来自 query string
2. 请求列表接口：实际端点由 SPA bundle 配置拼接而成，pcBaseUrl 为空、requestPrefix 是 /yzw，因此必须带前缀
3. 下载文书：列表可能返回多个文件，每个 wjlj 都是完整 OSS URL，可直接请求；URL 已做 percent 编码
4. 验证输出：确认下载结果是 PDF，再把文件交给用户

注意点

• API 路径缺少 /yzw 前缀会直接 404
• wjlj 是短时有效的预签名地址，要尽快下载，过期后重新请求列表接口
• 该流程是匿名的，mm 通常为空，不要用于账户登录、查案等场景
• pcBaseUrl 与 requestPrefix 来自前端 bundle 配置，平台改版后需重新确认
• OSS 地址绑定 *-oss.oss-cn-north-2-gov-1.aliyuncs.com，不要改区域端点

交付脚本

scripts/download_wssd.py 支持传入输出目录和三个 ID，也可用 --link 直接传完整链接，脚本会自动解析参数并完成下载。