curl -X PATCH "https://api.scanova.io/theme/user-42-ocean-breeze-a1b2c3/update/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"config_json": { "color": { "accent": "#005f99" } },
"clear_conflicting_overrides": true
}'
{
"id": 7,
"name": "Ocean Breeze",
"slug": "user-42-ocean-breeze-a1b2c3",
"description": "A cool blue palette.",
"config_json": { "color": { "accent": "#005f99", "background": "#f0f8ff" }, "font": { "heading": "Inter" } },
"schema_version": 2,
"category_hints": ["website-url", "vcard"],
"thumbnail_url": "https://cdn.scanova.io/themes/7/thumb.png",
"is_system": false,
"is_premium": false,
"order": 0
}
Temas y plantillas de página
Actualizar un tema
PATCH /theme//update/
PATCH
/
theme
/
{slug}
/
update
/
curl -X PATCH "https://api.scanova.io/theme/user-42-ocean-breeze-a1b2c3/update/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"config_json": { "color": { "accent": "#005f99" } },
"clear_conflicting_overrides": true
}'
{
"id": 7,
"name": "Ocean Breeze",
"slug": "user-42-ocean-breeze-a1b2c3",
"description": "A cool blue palette.",
"config_json": { "color": { "accent": "#005f99", "background": "#f0f8ff" }, "font": { "heading": "Inter" } },
"schema_version": 2,
"category_hints": ["website-url", "vcard"],
"thumbnail_url": "https://cdn.scanova.io/themes/7/thumb.png",
"is_system": false,
"is_premium": false,
"order": 0
}
Actualiza un tema propiedad de esta cuenta, en el host de la API de gestión (
Solo se admite
api.scanova.io), autenticado con su clave de API de gestión sin procesar.
PATCH https://api.scanova.io/theme/{slug}/update/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
requerido
El
slug del tema.string
Nuevo nombre del tema.
object
Nuevos tokens de diseño, siguiendo el esquema ThemeConfigV2.
boolean
Cuando es
true, elimina las theme_overrides por QR que entren en conflicto con los campos que está cambiando de todos los códigos QR que actualmente usan este tema — para que una edición aquí no deje anulaciones por QR obsoletas que la ensombrezcan.curl -X PATCH "https://api.scanova.io/theme/user-42-ocean-breeze-a1b2c3/update/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"config_json": { "color": { "accent": "#005f99" } },
"clear_conflicting_overrides": true
}'
{
"id": 7,
"name": "Ocean Breeze",
"slug": "user-42-ocean-breeze-a1b2c3",
"description": "A cool blue palette.",
"config_json": { "color": { "accent": "#005f99", "background": "#f0f8ff" }, "font": { "heading": "Inter" } },
"schema_version": 2,
"category_hints": ["website-url", "vcard"],
"thumbnail_url": "https://cdn.scanova.io/themes/7/thumb.png",
"is_system": false,
"is_premium": false,
"order": 0
}
PATCH (sin PUT). Aquí solo son escribibles sus propios temas que no sean del sistema — un tema del sistema o el de otra cuenta devuelve 404, igual que si no existiera, aunque Obtener un tema pueda leerlo. 400 si config_json no supera la validación del esquema.
Relacionado
- Obtener un tema — ver antes de actualizar.
- Obtener recuentos de uso de un tema — comprobar qué usa este tema antes de editarlo.
- 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: 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.
Parámetros de ruta
Respuesta
Theme updated.
¿Esta página le ayudó?