curl -X POST "https://api.scanova.io/qr-assets/design-template/" \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Blue Gradient",
"resource_type": "qr_category",
"category": 3,
"design_info": { "bg": "#0033ff" },
"gradient_type": "linear",
"is_template": true
}'
{
"id": 9,
"name": "Blue Gradient",
"resource_type": "qr_category",
"category": 3,
"design_info": { "bg": "#0033ff" },
"gradient_type": "linear",
"color_palette": null,
"font_styles": null,
"is_template": true,
"info": null,
"template_id": null
}
Recursos de QR
Crear una plantilla de diseño de usuario
POST /qr-assets/design-template/
POST
/
qr-assets
/
design-template
/
curl -X POST "https://api.scanova.io/qr-assets/design-template/" \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Blue Gradient",
"resource_type": "qr_category",
"category": 3,
"design_info": { "bg": "#0033ff" },
"gradient_type": "linear",
"is_template": true
}'
{
"id": 9,
"name": "Blue Gradient",
"resource_type": "qr_category",
"category": 3,
"design_info": { "bg": "#0033ff" },
"gradient_type": "linear",
"color_palette": null,
"font_styles": null,
"is_template": true,
"info": null,
"template_id": null
}
Guarda una nueva plantilla de diseño para una categoría de QR o un formulario, en el host de la API de gestión (
La regla de emparejamiento entre
api.scanova.io), autenticado con su clave de API de gestión sin procesar.
POST https://api.scanova.io/qr-assets/design-template/
Authorization: YOUR_API_KEY
string
requerido
Nombre de la plantilla, máximo 150 caracteres.
string
predeterminado:"qr_category"
qr_category o form.integer
El id de
QRCategory al que pertenece esta plantilla. Obligatorio cuando resource_type es qr_category; debe omitirse cuando resource_type es form.object
Datos de diseño JSON arbitrarios.
string
Estilo de degradado, p. ej.
linear.string
Paleta de colores, normalmente codificada como una cadena JSON.
string
Datos de estilo de fuente.
boolean
predeterminado:"false"
Marca este registro como una plantilla reutilizable en lugar de un guardado puntual.
curl -X POST "https://api.scanova.io/qr-assets/design-template/" \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Blue Gradient",
"resource_type": "qr_category",
"category": 3,
"design_info": { "bg": "#0033ff" },
"gradient_type": "linear",
"is_template": true
}'
{
"id": 9,
"name": "Blue Gradient",
"resource_type": "qr_category",
"category": 3,
"design_info": { "bg": "#0033ff" },
"gradient_type": "linear",
"color_palette": null,
"font_styles": null,
"is_template": true,
"info": null,
"template_id": null
}
La regla de emparejamiento entre resource_type y category
category es obligatorio para resource_type=qr_category y está prohibido para resource_type=form — tanto el serializer como una restricción de comprobación de la base de datos lo aplican, por lo que no puede haber inconsistencias. 400 con {"category": "This field is required for qr_category templates."} o el mensaje inverso si se invierte.
Relacionado
- Listar plantillas de diseño de usuario — ver plantillas guardadas.
- Actualizar una plantilla de diseño de usuario — editar una existente.
- Resumen de la API de gestión — el esquema de autenticación y las reglas de cuota aplicables a este endpoint.
Autorizaciones
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.
Respuesta
Template created.
¿Esta página le ayudó?