curl -X POST "https://api.scanova.io/page-template/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"name": "My Landing Page",
"description": "A custom page.",
"blocks_json": [{ "type": "hero" }],
"theme": 7,
"accent_color": "#0077be",
"preview_bg": "#f0f8ff"
}'
{
"id": 9,
"name": "My Landing Page",
"slug": "user-42-my-landing-page-d4e5f6",
"description": "A custom page.",
"category": null,
"theme": {
"id": 7,
"name": "Ocean Breeze",
"slug": "user-42-ocean-breeze-a1b2c3",
"description": "A cool blue palette.",
"config_json": { "color": { "accent": "#0077be", "background": "#f0f8ff" } },
"schema_version": 2,
"category_hints": ["website-url"],
"thumbnail_url": "https://cdn.scanova.io/themes/7/thumb.png",
"is_system": false,
"is_premium": false,
"order": 0
},
"blocks_json": [{ "type": "hero" }],
"filter_tags": [],
"accent_color": "#0077be",
"preview_bg": "#f0f8ff",
"thumbnail_url": null,
"is_premium": false,
"is_system": false,
"is_favourited": false,
"order": 0
}
Temas y plantillas de página
Crear una plantilla de página
POST /page-template/
POST
/
page-template
/
curl -X POST "https://api.scanova.io/page-template/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"name": "My Landing Page",
"description": "A custom page.",
"blocks_json": [{ "type": "hero" }],
"theme": 7,
"accent_color": "#0077be",
"preview_bg": "#f0f8ff"
}'
{
"id": 9,
"name": "My Landing Page",
"slug": "user-42-my-landing-page-d4e5f6",
"description": "A custom page.",
"category": null,
"theme": {
"id": 7,
"name": "Ocean Breeze",
"slug": "user-42-ocean-breeze-a1b2c3",
"description": "A cool blue palette.",
"config_json": { "color": { "accent": "#0077be", "background": "#f0f8ff" } },
"schema_version": 2,
"category_hints": ["website-url"],
"thumbnail_url": "https://cdn.scanova.io/themes/7/thumb.png",
"is_system": false,
"is_premium": false,
"order": 0
},
"blocks_json": [{ "type": "hero" }],
"filter_tags": [],
"accent_color": "#0077be",
"preview_bg": "#f0f8ff",
"thumbnail_url": null,
"is_premium": false,
"is_system": false,
"is_favourited": false,
"order": 0
}
Guarda una nueva plantilla de página, en el host de la API de gestión (
api.scanova.io), autenticado con su clave de API de gestión sin procesar.
POST https://api.scanova.io/page-template/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
requerido
Nombre de la plantilla. Se rechazan nombres vacíos o solo con espacios.
string
Descripción de la plantilla.
array
requerido
El contenido en bloques de la página — ya sea una lista de bloques, o un diccionario que contenga una clave
pages. Cualquier otra forma se rechaza.integer
Un id de tema para asociar con esta plantilla. Si el tema no es un tema del sistema, debe pertenecerle.
string
Color de acento, usado como respaldo cuando el tema vinculado no resuelve uno en vivo.
string
Color de fondo de vista previa, mismo rol de respaldo que
accent_color.curl -X POST "https://api.scanova.io/page-template/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"name": "My Landing Page",
"description": "A custom page.",
"blocks_json": [{ "type": "hero" }],
"theme": 7,
"accent_color": "#0077be",
"preview_bg": "#f0f8ff"
}'
{
"id": 9,
"name": "My Landing Page",
"slug": "user-42-my-landing-page-d4e5f6",
"description": "A custom page.",
"category": null,
"theme": {
"id": 7,
"name": "Ocean Breeze",
"slug": "user-42-ocean-breeze-a1b2c3",
"description": "A cool blue palette.",
"config_json": { "color": { "accent": "#0077be", "background": "#f0f8ff" } },
"schema_version": 2,
"category_hints": ["website-url"],
"thumbnail_url": "https://cdn.scanova.io/themes/7/thumb.png",
"is_system": false,
"is_premium": false,
"order": 0
},
"blocks_json": [{ "type": "hero" }],
"filter_tags": [],
"accent_color": "#0077be",
"preview_bg": "#f0f8ff",
"thumbnail_url": null,
"is_premium": false,
"is_system": false,
"is_favourited": false,
"order": 0
}
slug se genera en el servidor. Una miniatura se genera de forma asíncrona tras la creación — thumbnail_url empieza como null y se completa una vez finalizado ese proceso.
400 para un name vacío, un blocks_json malformado, o un theme que no es un tema del sistema y no le pertenece.
Relacionado
- Listar plantillas de página — ver plantillas guardadas (
?mine=true). - Actualizar una plantilla de página — editar una existente.
- Crear un tema — crear un tema para vincular mediante
theme. - 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.
Respuesta
Template created.
¿Esta página le ayudó?