Skip to main content
PUT
在 Management API 主机(api.scanova.io)上获取、更新或删除单个二维码,使用您的原始 Management API 密钥进行身份验证。
string
必填
该二维码的 qrid(例如 QR7K9M2XN)——由 GET /qr/ 返回的人类可读标识符,而非数字 id。
旧路径 /qrcode/{qrid}/ 出于向后兼容目的仍然可用——两个路径解析到完全相同的视图和行为。本参考文档记录的是规范路径 /qr/{qrid}/(与列出/创建端点使用相同的路径前缀)。
PUT 和 PATCH 均受支持(PUT 用于完整替换,PATCH 用于部分更新),并接受与创建二维码所述相同的字段集合。更新成功会返回 200 OK,并附带上方展示的更新后的详情表示。

作用范围与错误

此处的每个方法都只对该密钥所属账户拥有的二维码生效——请求一个您不拥有的(或不存在的)qrid 会返回 404,而非 403,因此您无法利用此端点探测其他账户的二维码是否存在。

相关内容

  • 获取 — 同一端点的另一个操作。
  • 删除 — 同一端点的另一个操作。
  • 列出二维码 —— 查找要在此处操作的 qrid,或本端点更新操作所接受的完整字段集合。
  • 创建二维码 —— 查找要在此处操作的 qrid,或本端点更新操作所接受的完整字段集合。
  • 下载二维码图片 —— 将此二维码渲染为图片文件。
  • 列出回收站中的二维码 —— 在此处执行 DELETE 后二维码会落入的位置。

授权

Authorization
string
header
必填

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: YOUR_API_KEY. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.

路径参数

qrid
string
必填

响应

200

QR code updated