Темы воркспейса

Управляйте темами оформления опросов в воркспейсе

Темы воркспейса

Темы оформления позволяют задавать цветовые схемы, шрифты, фоны и стили кнопок для опросов. Каждая тема привязана к воркспейсу и может применяться к нескольким опросам одновременно.

Базовый URL всех запросов раздела: /api/v3/service/workspace/{id}/themes, где {id} — ID воркспейса.

Скачайте markdown‑версию раздела «Темы воркспейса» для использования в ChatGPT / других LLM:

/static/api/themes.md
AI Markdown

Список тем воркспейса GET /api/v3/service/workspace/{id}/themes

Возвращает пагинированный список тем оформления для указанного воркспейса.

Query-параметры

Параметр Тип По умолчанию Описание
page integer 1 Номер страницы
per_page integer 20 Количество тем на странице
GET /api/v3/service/workspace/{id}/themes 
curl -X GET "https://api.webask.io/api/v3/service/workspace/1/themes?page=1&per_page=20" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Получить тему GET /api/v3/service/workspace/{id}/themes/{theme_id}

Возвращает полные данные конкретной темы, включая все поля цветов, стилей и метаданные.

Основные поля ответа

Поле Тип Описание
id integer ID темы
name string Название темы
header_color string Цвет шапки (HEX)
buttons_color string Цвет кнопок (HEX)
bg_color string Цвет фона (HEX)
widget_active_color string Цвет активного виджета (HEX)
base_font_id integer ID шрифта (см. справочник ниже)
base_font_title string Название шрифта
sort integer Порядок сортировки
created_at string Дата создания (ISO 8601)
updated_at string Дата последнего обновления (ISO 8601)
GET /api/v3/service/workspace/{id}/themes/{theme_id} 
curl -X GET "https://api.webask.io/api/v3/service/workspace/1/themes/42" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Создать тему POST /api/v3/service/workspace/{id}/themes

Создаёт новую тему в воркспейсе. Параметр quiz_id обязателен — тема создаётся на основе настроек указанного опроса. Все остальные поля необязательны и переопределяют значения из опроса.

Тело запроса (JSON)

Параметр Обяз. Описание
quiz_id да UUID опроса, на основе которого создаётся тема
name нет Название темы
header_color нет Цвет шапки (HEX)
buttons_color нет Цвет кнопок (HEX)
bg_color нет Цвет фона (HEX)
base_font_id нет ID шрифта (см. справочник ниже)
POST /api/v3/service/workspace/{id}/themes 
curl -X POST "https://api.webask.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": "Моя тема",
    "buttons_color": "#3B82F6",
    "bg_color": "#F9FAFB"
  }'

Обновить тему POST /api/v3/service/workspace/{id}/themes/{theme_id}

Частичное обновление темы — передаются только те поля, которые нужно изменить. Все параметры необязательны.

Параметры тела запроса

Параметр Тип Описание
name string Название темы
header_color string Цвет шапки (HEX)
buttons_color string Цвет кнопок (HEX)
bg_color string Цвет фона (HEX)
widget_active_color string Цвет активного виджета (HEX)
base_font_id integer ID шрифта (см. справочник)
buttons_type_id integer 1 — заливка, 2 — контур
buttons_radius integer Радиус скругления кнопок (px)
answer_options_radius integer Радиус скругления вариантов ответа (px)
answer_border boolean Показывать рамку у вариантов ответа
background_type_id integer 1 — цвет/изображение, 2 — градиент
background_opacity integer Прозрачность фона (0–100)
background_lightness integer Яркость фонового изображения
background_saturate integer Насыщенность фонового изображения
background_contrast integer Контраст фонового изображения
bg_gradient_start string Начальный цвет градиента (HEX)
bg_gradient_end string Конечный цвет градиента (HEX)
bg_gradient_vector integer Направление градиента (градусы, 0–360)
bg_image_file_id integer ID файла фонового изображения
background_position_id integer Позиция фона (см. справочник)
background_placement_id integer Размещение фона: 1 stretch, 2 drawin, 3 cover
bg_logo_file_id integer ID файла логотипа на фоне
bg_logo_position_id integer Позиция логотипа на фоне (см. справочник)
bg_logo_size_id integer Размер логотипа на фоне
POST /api/v3/service/workspace/{id}/themes/{theme_id} 
curl -X POST "https://api.webask.io/api/v3/service/workspace/1/themes/42" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Обновлённая тема",
    "buttons_color": "#10B981",
    "buttons_radius": 8
  }'

Скопировать тему POST /api/v3/service/workspace/{id}/themes/{theme_id}/copy

Создаёт полную копию темы в том же воркспейсе. Тело запроса не требуется. Ответ — объект новой созданной темы.

POST /api/v3/service/workspace/{id}/themes/{theme_id}/copy 
curl -X POST "https://api.webask.io/api/v3/service/workspace/1/themes/42/copy" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Удалить тему DELETE /api/v3/service/workspace/{id}/themes/{theme_id}

Удаляет тему воркспейса. Все опросы, использовавшие эту тему, автоматически переключаются на тему по умолчанию.

DELETE /api/v3/service/workspace/{id}/themes/{theme_id} 
curl -X DELETE "https://api.webask.io/api/v3/service/workspace/1/themes/42" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Справочники

Шрифты (base_font_id)

ID Шрифт ID Шрифт
1 Native (системный) 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

Тип кнопок (buttons_type_id)

ID Стиль
1 background (заливка)
2 border (контур)

Тип фона (background_type_id)

ID Тип
1 color_image (цвет или изображение)
2 gradient (градиент)

Размещение фона (background_placement_id)

ID Режим
1 stretch (растянуть)
2 drawin (оригинальный размер)
3 cover (заполнить)

Позиция фона (background_position_id)

ID Позиция
1center center
2left center
3right center
4center top
5center bottom
6left top
7right top
8left bottom
9right bottom