创建二维码 - Scanova API Documentation

curl -X POST "https://api.scanova.io/qr/" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": 1,
    "info": "{\"type\":\"url\",\"data\":{\"url\":\"https://example.com\"}}",
    "qr_type": "dy",
    "name": "Product launch flyer"
  }'

POST

/

qr

/

curl -X POST "https://api.scanova.io/qr/" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": 1,
    "info": "{\"type\":\"url\",\"data\":{\"url\":\"https://example.com\"}}",
    "qr_type": "dy",
    "name": "Product launch flyer"
  }'

在 Management API 主机（api.scanova.io）上列出或创建二维码，使用您的原始 Management API 密钥进行身份验证——如果您还没有设置好密钥，请参见概览。

GET  https://api.scanova.io/qr/
POST https://api.scanova.io/qr/
Authorization: YOUR_API_KEY

POST /qr/ 使用与常规仪表盘创建二维码端点相同的序列化器和字段约定来创建一个新的二维码。这里不重新罗列完整的字段参考，请参见创建二维码获取完整的必填/可选字段表（category、info、name、qr_type，以及 pattern_info、custom_domain、expire_on、lead_list 等高级字段和地理围栏选项）——那里文档记录的每个字段在此处都同样适用。

curl -X POST "https://api.scanova.io/qr/" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": 1,
    "info": "{\"type\":\"url\",\"data\":{\"url\":\"https://example.com\"}}",
    "qr_type": "dy",
    "name": "Product launch flyer"
  }'

创建成功会返回 201 Created，其中包含新创建的二维码，以完整的详情数据结构进行序列化（与 GET /qr/{qrid}/ 返回的结构相同）——比上方展示的精简列表结构更丰富，包含列表端点出于性能考虑而省略的 info、pattern_info 等字段。创建二维码与从仪表盘创建二维码一样，受到相同的、基于套餐的二维码数量限制（动态/静态）的约束，此外还要通过概览中所述的 MANAGEMENT_API（或 INTEGRATION_ZAPIER/INTEGRATION_MCP）配额门槛。

相关内容

列出二维码 — 同一端点的另一个操作。
获取 —— 对此列表中返回的单个二维码进行操作。
更新 —— 对此列表中返回的单个二维码进行操作。
删除 —— 对此列表中返回的单个二维码进行操作。
下载二维码图片 —— 将这些二维码之一渲染为 PNG/SVG/PDF 等格式。
列出回收站中的二维码 —— 从此列表中删除后二维码会去往何处。
Management API 概览 —— 适用于本端点的身份验证方案与配额规则。

授权

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.

响应

201

QR code created