curl -X PATCH "https://api.scanova.io/qr-assets/template/12/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "name": "Winter Poster" }'
{
"id": 12,
"name": "Winter Poster",
"template_id": "a1b2c3d4e5f6",
"template_type": "P",
"template_type_display": "Poster",
"pattern_info": "{\"dotStyle\":\"round\"}",
"image": "https://cdn.scanova.io/upload/images/42/template-foo.png"
}
QR 资源
更新 QR 码设计模板
PATCH /qr-assets/template//
PATCH
/
qr-assets
/
template
/
{pk}
/
curl -X PATCH "https://api.scanova.io/qr-assets/template/12/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "name": "Winter Poster" }'
{
"id": 12,
"name": "Winter Poster",
"template_id": "a1b2c3d4e5f6",
"template_type": "P",
"template_type_display": "Poster",
"pattern_info": "{\"dotStyle\":\"round\"}",
"image": "https://cdn.scanova.io/upload/images/42/template-foo.png"
}
在 Management API 主机(
同时支持
api.scanova.io)上更新账户拥有的 QR 设计模板,使用您的原始 Management API 密钥进行身份验证。
PUT https://api.scanova.io/qr-assets/template/{pk}/
PATCH https://api.scanova.io/qr-assets/template/{pk}/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
integer
必填
模板的
id。PUT(完整替换)和 PATCH(部分更新),二者接受与创建 QR 码设计模板中记录相同的 name/pattern_info/image 字段。
curl -X PATCH "https://api.scanova.io/qr-assets/template/12/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "name": "Winter Poster" }'
{
"id": 12,
"name": "Winter Poster",
"template_id": "a1b2c3d4e5f6",
"template_type": "P",
"template_type_display": "Poster",
"pattern_info": "{\"dotStyle\":\"round\"}",
"image": "https://cdn.scanova.io/upload/images/42/template-foo.png"
}
template_type 无法在此更改
template_type 仅在创建时可设置——在 PUT/PATCH 请求体中发送该字段会被静默忽略,而不是报错,因此模板在其整个生命周期内保持原始的海报/普通类型。如果 pk 不是该账户拥有的模板,则返回 404。
相关内容
- 获取 QR 码设计模板——更新前先查看。
- 创建 QR 码设计模板——此更新复用的字段参考。
- 删除 QR 码设计模板——将其彻底删除。
- Management API 概览——适用于此端点的身份验证方案和配额规则。
授权
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. 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.
路径参数
响应
Template updated.
此页面对您有帮助吗?