Temas
Gestione los temas de diseño de encuestas en su espacio de trabajo
Temas del espacio de trabajo
Los temas de diseño le permiten definir esquemas de color, fuentes, fondos y estilos de botones para las encuestas. Cada tema está vinculado a un espacio de trabajo y puede aplicarse a múltiples encuestas a la vez.
URL base para todas las solicitudes de esta sección: /api/v3/service/workspace/{id}/themes, donde {id} — es el ID del espacio de trabajo.
Descargue la versión en markdown de la sección «Temas del espacio de trabajo» para usar en ChatGPT / otros LLMs:
AI Markdown
/static/api/themes.md
AI Markdown
Listar temas del espacio de trabajo GET /api/v3/service/workspace/{id}/themes
Devuelve una lista paginada de temas de diseño para el espacio de trabajo especificado.
Parámetros de consulta
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
| page | integer | 1 | Número de página |
| per_page | integer | 20 | Temas por página |
GET /api/v3/service/workspace/{id}/themes
curl -X GET "https://api.surveyninja.io/api/v3/service/workspace/1/themes?page=1&per_page=20" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Accept: application/json"Obtener tema GET /api/v3/service/workspace/{id}/themes/{theme_id}
Devuelve los datos completos de un tema específico, incluyendo todos los campos de color, estilo y metadatos.
Campos principales de la respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| id | integer | ID del tema |
| name | string | Nombre del tema |
| header_color | string | Color del encabezado (HEX) |
| buttons_color | string | Color de botón (HEX) |
| bg_color | string | Color de fondo (HEX) |
| widget_active_color | string | Color del widget activo (HEX) |
| base_font_id | integer | ID de fuente (ver referencia abajo) |
| base_font_title | string | Nombre de la fuente |
| sort | integer | Orden de clasificación |
| created_at | string | Creado el (ISO 8601) |
| updated_at | string | Actualizado el (ISO 8601) |
GET /api/v3/service/workspace/{id}/themes/{theme_id}
curl -X GET "https://api.surveyninja.io/api/v3/service/workspace/1/themes/42" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Accept: application/json"Crear tema POST /api/v3/service/workspace/{id}/themes
Crea un nuevo tema en el espacio de trabajo. El parámetro quiz_id es obligatorio — el tema se crea basándose en la configuración de la encuesta especificada. Todos los demás campos son opcionales y sobrescriben los valores de la encuesta.
Cuerpo de la solicitud (JSON)
| Parámetro | Req. | Descripción |
|---|---|---|
| quiz_id | Sí | UUID de la encuesta en la que se basa el tema |
| name | No | Nombre del tema |
| header_color | No | Color del encabezado (HEX) |
| buttons_color | No | Color de botón (HEX) |
| bg_color | No | Color de fondo (HEX) |
| base_font_id | No | ID de fuente (ver referencia abajo) |
POST /api/v3/service/workspace/{id}/themes
curl -X POST "https://api.surveyninja.io/api/v3/service/workspace/1/themes" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "quiz_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "name": "My Theme", "buttons_color": "#3B82F6", "bg_color": "#F9FAFB" }'Actualizar tema POST /api/v3/service/workspace/{id}/themes/{theme_id}
Actualización parcial del tema — envíe solo los campos a modificar. Todos los parámetros son opcionales.
Parámetros del cuerpo de la solicitud
| Parámetro | Tipo | Descripción |
|---|---|---|
| name | string | Nombre del tema |
| header_color | string | Color del encabezado (HEX) |
| buttons_color | string | Color de botón (HEX) |
| bg_color | string | Color de fondo (HEX) |
| widget_active_color | string | Color del widget activo (HEX) |
| base_font_id | integer | ID de fuente (ver referencia) |
| buttons_type_id | integer | 1 — relleno, 2 — con borde |
| buttons_radius | integer | Radio del borde del botón (px) |
| answer_options_radius | integer | Radio del borde de las opciones de respuesta (px) |
| answer_border | boolean | Mostrar borde en las opciones de respuesta |
| background_type_id | integer | 1 — color/imagen, 2 — degradado |
| background_opacity | integer | Opacidad del fondo (0–100) |
| background_lightness | integer | Brillo de la imagen de fondo |
| background_saturate | integer | Saturación de la imagen de fondo |
| background_contrast | integer | Contraste de la imagen de fondo |
| bg_gradient_start | string | Color inicial del degradado (HEX) |
| bg_gradient_end | string | Color final del degradado (HEX) |
| bg_gradient_vector | integer | Dirección del degradado (grados, 0–360) |
| bg_image_file_id | integer | ID del archivo de imagen de fondo |
| background_position_id | integer | Posición del fondo (ver referencia) |
| background_placement_id | integer | Disposición del fondo: 1 estirar, 2 tamaño original, 3 cubrir |
| bg_logo_file_id | integer | ID del archivo del logo de fondo |
| bg_logo_position_id | integer | Posición del logo de fondo (ver referencia) |
| bg_logo_size_id | integer | Tamaño del logo de fondo |
POST /api/v3/service/workspace/{id}/themes/{theme_id}
curl -X POST "https://api.surveyninja.io/api/v3/service/workspace/1/themes/42" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "Updated theme", "buttons_color": "#10B981", "buttons_radius": 8 }'Copiar tema POST /api/v3/service/workspace/{id}/themes/{theme_id}/copy
Crea una copia completa del tema en el mismo espacio de trabajo. No se requiere cuerpo de solicitud. La respuesta es el nuevo objeto de tema.
POST /api/v3/service/workspace/{id}/themes/{theme_id}/copy
curl -X POST "https://api.surveyninja.io/api/v3/service/workspace/1/themes/42/copy" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Accept: application/json"Eliminar tema DELETE /api/v3/service/workspace/{id}/themes/{theme_id}
Elimina un tema del espacio de trabajo. Todas las encuestas que usan este tema se cambian automáticamente al tema predeterminado.
DELETE /api/v3/service/workspace/{id}/themes/{theme_id}
curl -X DELETE "https://api.surveyninja.io/api/v3/service/workspace/1/themes/42" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Accept: application/json"Tablas de referencia
Fuentes (base_font_id)
| ID | Fuente | ID | Fuente |
|---|---|---|---|
| 1 | Nativa (sistema) | 23 | Nunito |
| 2 | Roboto | 24 | Oswald |
| 3 | Open Sans | 25 | Playfair Display |
| 4 | Lato | 26 | PT Sans |
| 5 | Montserrat | 27 | PT Serif |
| 6 | Raleway | 28 | Rubik |
| 7 | Source Sans Pro | 29 | Ubuntu |
| 8 | Roboto Condensed | 30 | Manrope |
| 9 | Roboto Mono | 31 | Inter |
| 10 | Roboto Slab | 32 | Mulish |
| 11 | Noto Sans | 33 | Poppins |
| 12 | Noto Serif | 34 | Quicksand |
| 13 | Merriweather | 35 | Comfortaa |
| 14 | Libre Baskerville | 36 | Exo 2 |
| 15 | Lobster | 37 | Fira Sans |
| 16 | Pacifico | 38 | Cabin |
| 17 | Dancing Script | 39 | Nunito Sans |
| 18 | Caveat | 40 | Jost |
| 19 | Permanent Marker | 41 | Unbounded |
| 20 | Indie Flower | 42 | Wix Madefor Display |
| 21 | Abril Fatface | 43 | Onest |
| 22 | Fjalla One | 44 | Golos Text |
Tipo de botón (buttons_type_id)
| ID | Estilo |
|---|---|
| 1 | fondo (relleno) |
| 2 | borde (con contorno) |
Tipo de fondo (background_type_id)
| ID | Tipo |
|---|---|
| 1 | color_imagen (color o imagen) |
| 2 | degradado (degradado) |
Disposición del fondo (background_placement_id)
| ID | Modo |
|---|---|
| 1 | estirar |
| 2 | tamaño original |
| 3 | cubrir |
Posición del fondo (background_position_id)
| ID | Posición |
|---|---|
| 1 | center center |
| 2 | left center |
| 3 | right center |
| 4 | center top |
| 5 | center bottom |
| 6 | left top |
| 7 | right top |
| 8 | left bottom |
| 9 | right bottom |