从 v1 迁移到当前版本

v1 接口还能调用，但不再更新。两个版本用同一把 OpenAPI Key，鉴权不用改。

接口对照表

v1 接口	当前版本	变化
POST /api/v1/qrcode/read_markdown	POST /api/v2/rpc/qrcodes/getContent	入参 qrcodeUrl 改为 qrcode（coding 或完整 URL），加 format: "markdown"
POST /api/v1/qrcode/read_json	POST /api/v2/rpc/qrcodes/getContent	入参同上，format: "json"；返回结构不同，按新文档调整解析
POST /api/v1/form/get_data	POST /api/v2/rpc/record/getRecords	按 filters 筛选记录；字段结构用表单结构读取
GET /api/v1/getTemplateMeta	POST /api/v2/rpc/templates/get	改为 POST；入参 templateCode 改为 template，传批量模板的 coding 或完整 URL，从模板列表获取
GET /api/v1/getQrcodeMsg	POST /api/v2/rpc/templates/getSubcode	改为 POST，同时传 template 和 subcode
POST /api/v1/certificate/verification	POST /api/v2/rpc/certificates/verify	用 action_type 指定核销动作，要求 API Key 具备写权限
POST /api/v1/qrcode/get_updates	POST /api/v2/rpc/record/getRecords	只覆盖表单记录，状态变更等其他动态类型暂无替代

字段定义页对应关系：富文本模块（ContentModule）→ 活码内容；表单字段（FormField）→ 表单结构和组件类型；模板组件 → 模板结构；子码组件（获取子码内容）→ 子码内容。

暂时没有替代的接口

下面这些接口当前版本还没有提供，继续用原来的调用方式，它们也列在 API 参考对应分组里，标为 v1。

接口	文档
POST /api/v1/createSubCode	建子码
POST /api/v1/editSubCode	改子码
POST /api/v1/deleteSubCode	删子码
POST /api/member/addMember	批量新增成员
POST /api/v1/qrcode/scan_url	识别码的来源

让 AI 来调的话

建码、批量建子码这类写操作，如果调用方是 AI，可以直接用管理端 MCP，不必经过 v1 接口。