Документация

Формы

В интерфейсе "Мои формы" отображается ваш актуальный список форм. Каждая форма представлена в виде блока, содержащего название, краткий список настроек и описание.

Кликнув по блоку формы, вы перейдете в интерфейс для работы с этой конкретной формой.

Сводка формы

На вкладке формы "Детали" отображается краткая сводка настроек формы, количество вопросов, количество заполненных результатов пользователей, текущий статус формы и другое.
Также на этой вкладке находится кнопка включения/отключения формы (Опубликовать/Снять с публикации).

Вопросы

На вкладке формы "Вопросы" отображается список уже добавленных вопросов.
Каждый вопрос представлен в виде блока, содержащего название, краткий список настроек и кнопок Редактирования и Удаления.
Если настройка "Разбить на страницы" установлена в значение Для нескольких вопросов то будет доступна кнопка "Добавить страницу" для добавления страниц и последующего распределения вопросов между ними.
Слева от каждого блока вопроса есть "якорь" который выглядит так :, кликнув и удерживая мышью за который можно перемещать блоки вопросов и менять их очередность или перемещать между страницами.
Для добавления нового вопроса нужно нажать кнопку "Добавить вопрос" в верхней части формы. После этого откроется панель конфигурации вопроса, где вы сможете настроить вопрос, добавить описание, варианты ответов и другое.

Кроме ручного добавления, для работы с банком вопросов доступны и дополнительные сценарии:
Импорт вопросов — отдельный интерфейс импорта позволяет загрузить вопросы из JSON-файла или вставить JSON вручную. При импорте можно сразу задать общие параметры, например уровень сложности и количество баллов, если они применимы к текущей форме.
AskiumAI — генератор вопросов на основе искусственного интеллекта позволяет по теме, сложности и другим параметрам автоматически создать набор вопросов с вариантами ответов. Сгенерированные вопросы добавляются в текущую форму.

На странице Импорт вопросов доступны две вспомогательные кнопки: "Пример формата ожидаемого JSON" и "Пример промпта для генерации через AI". Вторая открывает готовый шаблон промпта, где можно подставить тему, количество вопросов, количество вариантов ответа, сложность и язык генерации, а затем скопировать этот промпт для использования в стороннем AI-сервисе.

Импорт поддерживает не только загрузку локального JSON-файла, но и вставку исходного raw JSON в окно вручную. Если JSON был сгенерирован AI, можно вставить как чистый JSON, так и весь json code block из ответа модели. После запуска импорт выполняется как фоновая задача: страница показывает статус обработки, а после успешного завершения открывает список импортированных вопросов.

Интерфейс импорта доступен только для форм типов Викторина и Экзамен и только на тарифах Plus или Pro. Если в форме включена система баллов, то при обычном импорте можно задать общее количество баллов вручную, а в экзамене с включённой Системой сложности баллы для импортируемых вопросов будут назначены автоматически на основе выбранной сложности.

Конфигурация вопроса

Для пользователя доступен ряд конфигураций для настройки вопроса и определения каким именно образом пользователь даст на него ответ какой эффект он окажет на результат.
Сразу стоит заметить, доступность некоторых настроек зависит от других настроек, также они могут взаимоисключать одна другую.

Независимо от того, был ли вопрос создан вручную, импортирован или сгенерирован через AskiumAI, после добавления его можно открыть в этом интерфейсе и отредактировать все доступные параметры.

Полный список настроек вопроса:

• Название — название вопроса которое будет видно только вам в интерфейсе и в списке вопросов формы или экзаменационного билета. Рекомендуется максимально кратко, в 2-3 слова указать для себя о чем вопрос. Обязательное поле.
• Описание — описание вопроса которое будет отображаться для ваших пользователей в форме, тесте или экзамене. Является обязательным.
  Для обладателей плана "Plus" или "Pro" доступна расширенная версия редактора для описания, с возможностью вводить текст со сложным форматированием, например, изменять размер, цвет и стиль шрифта, добавлять списки, изображения, видео, блоки кода с подсветкой синтаксиса или математические формулы.
• Пропускаемый —настройка, определяющая, может ли пользователь пропустить ответ на этот вопрос и продолжить, или ответ является обязательным для заполнения.
  Если параметр формы "Разбить на страницы" установлен в значение "Для одного вопроса", то будет доступна кнопка "Пропустить"
• Тип ответа — главная настройка вопроса, определяющая способ дачи ответа на него. На выбор доступны такие типы:
  • Список вариантов — пользователь должен выбрать один или несколько из предложенных вариантов ответа. Вы также можете разрешить пользователю вводить свой вариант ответа или установить какие варианты правильные а какие нет.
  • Поле ввода — пользователь должен ввести свой ответ в предоставленное поле ввода. Тип и свойства этого поля определяются в последующих настройках.
  • Выбор даты — пользователь должен выбрать дату в специальном селекторе выбора даты.
  • Диапазон — пользователь устанавливает значение при помощи горизонтального ползунка. При перемещении ползунка значение мгновенно изменяется.
  • Рейтинг — это ряд из символов (обычно это звезды), кликнув по которым, пользователь устанавливает значение, значение определяется порядковым номером символа в ряду.
  • Персональные данные — это специальный тип, в котором определятся персональные данные пользователя, такие как имя, фамилия и email. Эти данные помогут ориентироваться в списках результатов и находить результаты конкретного пользователя по данным введенным в эти поля.
• Тип списка вариантов — под-настройка Списка вариантов, определяющая сколько вариантов из предложенных может выбрать пользователь. На выбор доступно 2 типа:
  • Список с одним вариантом — пользователь может выбрать только один вариант.
  • Список с несколькими вариантами — пользователь может выбрать один или несколько вариантов.
• Корректность — под-настройка Списка вариантов, определяющая будут ли варианты ответов делиться на правильные и не правильные.
• Свой ответ — под-настройка Списка вариантов, определяющая сможет ли пользователь дать собственный вариант ответа. Не доступна если настройка "Корректность" включена.
• Уровень сложности — под-настройка Списка вариантов, если выбран тип формы "Экзамен", а также включена настройка "Система сложности" определяющая к какой группе сложности относится текущий вопрос. Указывать обязательно.
• Варианты ответов — под-настройка Списка вариантов, список доступных для выбора пользователю вариантов ответа на текущий вопрос. Для добавления нового варианта ответа нужно кликнуть по кнопке "Добавить вариант" и он динамически добавится в конец списка вариантов.
  Для каждого варианта ответа доступно перемещение для изменения очередности а также кнопка удаления.
  Если включена Корректность то для каждого варианта будет доступна метка "Правильного" варианта ответа. Если был выбран "Список с несколькими вариантами" то правильных вариантом может быть несколько, но в любом случае не меньше одного,
• Тип поля — под-настройка Поля ввода, определяющая свойства поля и типов данных которые туда можно будет ввести. На выбор доступно 5 типов:
  • Одна строка — самое обычное текстовое поле без возможности сделать перенос.
  • Многострочный ввод — текстовое поле где можно сделать перенос.
  • Число — числовое поле куда будет можно ввести только целые числа.
  • Дробное число — числовое поле куда будет можно ввести целые числа или числа с плавающей точкой (дробные).
  • Email — поле для ввода Email.
• Тип персональных данных — под-настройка Персональных данных, определяющая какие именно данные ожидаются в конкретном поле:
  • Имя
  • Фамилия
  • Email
• Мин. длина — под-настройка Поля ввода, если выбран тип Одна строка или Многострочный ввод, определяющая минимальную допустимую длину вводимой строки. Может быть только целым числом не меньше 0. Указывать необязательно.
• Макс. длина — под-настройка Поля ввода, если выбран тип Одна строка или Многострочный ввод, определяющая максимальную допустимую длину вводимой строки. Может быть только целым числом не меньше 0. Указывать необязательно.
• Кол-во строк по умолчанию — под-настройка Поля ввода, если выбран тип Многострочный ввод, изначальную высоту поля ввода в строках. Может быть только целым числом не меньше 1. Указывать необязательно.
• Мин — под-настройка Поля ввода, если выбран тип Число или Дробное число, определяющая минимальное допустимое значение вводимое в это поле. Может быть только целым числом. Указывать необязательно.
• Макс — под-настройка Поля ввода, если выбран тип Число или Дробное число, определяющая максимальное допустимое значение вводимое в это поле. Может быть только целым числом. Указывать необязательно.
• Шаг — под-настройка Поля ввода, если выбран тип Число или Дробное число, определяющая число, кратным которому должно быть значение вводимое в это поле. Может быть только целым числом. Указывать необязательно.

Особенности Экзамена

В форме типа "Экзамен" тип вопроса всегда "Список вариантов" и изменить его нельзя. Также нельзя отключить Корректность и нельзя включить Свой ответ, так что это контроллеры будут скрыты.

Импорт вопросов

Страница импорта открывается из интерфейса вопросов текущей формы. Она доступна только для форм типов Викторина и Экзамен и только на тарифах Plus или Pro. Внутри интерфейса можно выбрать общий уровень сложности для всех импортируемых вопросов и, если форма использует систему баллов вне режима экзаменационной сложности, указать единое количество баллов вручную.

На странице встроены две вспомогательные кнопки: "Пример формата ожидаемого JSON" и "Пример промпта для генерации через AI". Первая показывает точный контракт JSON с ключами question_short_title, question, options и correct_index. Вторая открывает готовый шаблон промпта, куда можно подставить тему, количество вопросов, количество вариантов ответа, сложность и язык, а затем скопировать его для использования во внешнем AI-сервисе.

{
  "questions": [
    {
      "question_short_title": "HTTP status codes",
      "question": "Which status code means that the request was successful?",
      "options": [
        "200 OK",
        "301 Moved Permanently",
        "404 Not Found",
        "500 Internal Server Error"
      ],
      "correct_index": 0
    }
  ]
}

Импорт можно выполнить двумя способами: загрузить локальный JSON-файл или вставить исходный raw JSON вручную. Если данные были получены из AI-модели, система также принимает весь json code block из ответа. После запуска импорт выполняется как фоновая задача: страница автоматически проверяет статус, а после успешного завершения открывает список импортированных вопросов, где их можно просмотреть и при необходимости доработать.

Если форма является экзаменом с включённой Системой сложности, баллы для импортируемых вопросов назначаются автоматически на основе выбранного уровня сложности. Это позволяет использовать один и тот же сценарий импорта как для обычных тестов с ручной оценкой, так и для экзаменов с балансировкой сложности.

AskiumAI: генератор вопросов

AskiumAI — это отдельная страница для генерации вопросов непосредственно внутри текущей формы. В интерфейсе отображается ваш текущий остаток AI-токенов, а сама генерация предназначена для быстрого наполнения банка вопросов без переключения на сторонние инструменты. Генерация доступна только для форм типов Викторина и Экзамен; для остальных типов интерфейс показывает предупреждение и не позволяет запустить задачу.

На странице генератора задаются предметная область / тема, сложность, количество вопросов и количество вариантов ответа. Если в форме включена система баллов вне режима экзаменационной сложности, можно также указать количество баллов за правильный ответ. Язык сгенерированных вопросов определяется локализацией самой формы, а не текущим языком административного интерфейса.

После запуска AskiumAI сначала проверяет тему, затем выполняет генерацию как фоновую задачу. Страница показывает промежуточные состояния, автоматически опрашивает статус процесса и после успешного завершения открывает список сгенерированных вопросов. Полученные вопросы и варианты ответов всегда рекомендуется перепроверять вручную, поскольку искусственный интеллект может допускать ошибки.

После генерации список вопросов можно просмотреть, отредактировать, частично удалить или оставить только нужные элементы, прежде чем продолжать работу с формой.

Настройки сложности

Если выбран тип формы "Экзамен" и включена настройка "Система сложности" то будет доступна вкладка "Настройки сложности".
На этой вкладке можно настроить среднюю сложности экзаменационного билета.
Для этого нужно указать сколько вопросов какой сложности будет в каждом экзаменационном билете. Всего добавлено 5 уровней сложности:

• Очень простой
• Простой
• Средний
• Трудный
• Очень трудный

Во время автоматической генерации экзаменационных билетов будет браться указанное вами количество вопросов определенной сложности, но в случайном порядке. Таким образом, общий уровень сложности вопросов в билетах будет сбалансирован, в тоже время набор вопросов в каждом билете будет уникален.

Вы сами выбираете какие уровни использовать а какие нет, использовать весь диапазон уровней вовсе не обязательно. Обычно используют 2-3 уровня, к примеру от Простого до Трудного.

Также, если включена настройка "Система баллов", на этой вкладке вы можете указать сколько баллов за какой уровень сложности будет присваиваться, т.к. в комбинации настроек "Система баллов" и "Система сложности" указывать баллы индивидуально на каждый вопрос уже нельзя, а только на этой вкладке.

Пригласительные ссылки

Эта вкладка доступна если в конфигурации формы включена функция "Доступ - Только по приглашению"

На вкладке "Пригласительные ссылки" по-умолчанию отображается актуальный список активных пригласительных ссылок.
Каждая ссылка представлена в виде блока, содержащего общую информацию:

• Полный URL-адрес ссылки
• Имя и фамилия приглашенного пользователя, если указаны
• E-mail адрес приглашенного пользователя, если указан
• Количество вопросов в экзаменационном билете, если тип формы — Экзамен

Также в каждом блоке есть переключатель для включения/выключения ссылки, и набор кнопок для работы со ссылкой:

• Кнопка оправки приглашения на электронную почту, если E-mail адрес указан в ссылке, недоступна если ссылка уже была отправлена, использована или отключена;
• Кнопка копирования URL-адреса в буфер обмена, недоступна если ссылка отключена;
• Кнопка "Поделиться" для отправки ссылки в соцсети, мессенджеры, по почте и др., недоступна если ссылка уже была использована или отключена;
• Кнопка генерации QR-кода с текущей ссылкой, недоступна если ссылка отключена;
• Кнопка редактирования ссылки, недоступна если ссылка уже была использована;
• Кнопка удаления ссылки, недоступна если ссылка уже была использована;
• Кнопка перехода к результатам пользователя, доступна только после того как ссылка уже была использована;

Кликнув по блоку пригласительной ссылки, вы перейдете в интерфейс для работы с этой конкретной ссылкой.

Для добавления новой пригласительной ссылки нужно нажать кнопку "Добавить" после чего вы попадете на интерфейс создания новой пригласительной ссылки.

Создание пригласительной ссылки

При создании новой пригласительной ссылки доступны следующие поля:

• Имя
• Фамилия
• Email

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

В момент создания пригласительной ссылки, каждой из них присваивается уникальный ключ, который добавляется к URL самой ссылки. Если пригласительная ссылка остается анонимной (без имени, фамилии и Email) то единственным идентификатором остается уникальный ключ

Если ваши пользователи (клиенты/сотрудники/студенты/...) являются постоянными то у вас есть возможность сохранять их данные в список контактов нажатием кнопки "Сохранить контакт", а также импортировать данные из него нажав кнопку "Импорт" и выбрав нужный контакт из списка.

Если текущий тип формы — "Экзамен" то после создания пригласительной ссылки вы сразу попадете в интерфейс для работы с ней, с целью наполнения экзаменационного билета вопросами, т.к. изначально он будет пуст.

Редактирование пригласительной ссылки

В целом, интерфейс редактирования пригласительной ссылки похож на интерфейс создания, только добавится переключатель статуса ссылка (включен/выключен) и отобразится ее уникальный ключ.

Экзаменационный билет

Если тип формы — "Экзамен" то в интерфейсе редактирования пригласительной ссылки также будет доступна 2 часть предназначенная для работы с экзаменационным билетом и наполнением его вопросами.
Наполнить экзаменационный билет вопросами можно 2 способами:

• Нажав кнопку "Сгенерировать билет" — билет будет мгновенно наполнен вопросами, исходя из настроек сложности (если в форме включена функция "Система сложности", настройки сложности заполнены, а также форму должно быть добавлено достаточное количество вопросов соответствующих уровней сложности).
• Наполнив вопросами вручную, нажимая кнопку "Добавить вопрос" и выбирая нужные вопросы из списка (можно несколько за раз).

В уже наполненном экзаменационном билете можно изменять очередность вопросов перемещая их за якорь , и удалять их нажимая соответствующую кнопку удаления.

В типе формы — "Экзамен" активировать пригласительную ссылку в билет которой не добавлены вопросы — нельзя.

Список контактов

Эта вкладка доступна если в конфигурации формы включена функция "Доступ - Только по приглашению"

Тут отображается список контактов ваших пользователей (клиентов/сотрудников/студентов/...). Нужен этот список для того чтобы в дальнейшем импортировать данные пользователей (имя, фамилия и Email) в пригласительные ссылки, тем самым упростив их создание.

Для добавления нового контакта нужно нажать кнопку "Добавить" после чего вы попадете на интерфейс создания нового контакта.

В каждом контакте есть 3 поля:

• Имя
• Фамилия
• Email

Для сохранения контакта необходимо заполнить все поля. Также стоит заметить что Email в вашем списке контактов не может повторяться.

Результаты

На этой вкладке отображается список результатов заполнения формы пользователями. Каждый результат представлен в виде блока с краткой информацией:

• Ключ — Уникальный ключ каждого результата;
• Статус результата, В процессе или Завершен;
• Дата и время момента завершения заполнения формы;
• Имя и фамилия пользователя, если в форме включен Доступ только по приглашению и в пригласительной ссылке были указаны имя/фамилия пользователя;
• Email пользователя, если в форме включен Доступ только по приглашению и в пригласительной ссылке был указан Email пользователя;
• Баллы которые пользователь набрал в этом результате, если в форме включена функция Система баллов;
• Процент % правильных ответов, если тип формы Викторина или Экзамен;

Кликнув по блоку результата вы перейдете на страницу с детальной информацией по текущему результату:

• Общей сводкой;
• Журналом нежелательных действий (если функция "Мониторинг действий" была включена);
• Статусом прокторинга через веб-камеру и таймлайном событий по прокторингу, если для экзамена была включена эта функция;
• полным списком ответов на вопросы формы, с указанием правильности ответа, если такой имеется;

Аналитика

На вкладке Аналитика отображается общая сводка по всем результатам за все время существования текущей формы.

Тут представлена следующая информация:

• Графики заполнения — графики отображающие динамику заполнения формы пользователями:
  • Посуточный график — график отображающий сколько раз в день была заполнена форма за последние 30 дней.
  • Помесячный график — график отображающий сколько раз в месяц была заполнена форма за последние 12 месяцев.
• Статистика результатов — обобщенные статистические данные по результатам за все время:
  • Общее количество результатов
  • Общее количество баллов в форме
  • Среднее количество баллов полученное пользователями
  • Максимальное количество баллов полученное пользователями
  • Минимальное количество баллов полученное пользователями
  • Средний процент правильных ответов пользователей
  • Максимальный процент правильных ответов пользователей
  • Минимальный процент правильных ответов пользователей
• Статистика вопросов — обобщенные статистические данные за все время по каждому вопросу индивидуально.
  Если это вопрос с вариантами ответов то:
  • Количество и относительный процент пропусков вопроса;
  • Количество и относительный процент правильного ответа на вопрос;
  • Сравнительная статистическая таблица по каждому варианту ответа;
  • Сравнительный график по каждому варианту ответа;
  
  Если это вопрос с полем ввода числа то:
  • Количество и относительный процент пропусков вопроса;
  • Среднее значение ответа;
  • Максимальное значение ответа;
  • Минимальное значение ответа;
  
  Если это вопрос с полем ввода строки или дата то полный список ответов на этот вопрос

Аналитику также можно экспортировать в PDF и Excel. Экспорт подготавливается в фоновом режиме, после чего сформированный файл становится доступен для скачивания.

Брендирование и стилизация

На этой вкладке вы можете настраивать визуальный стиль формы в режиме предпросмотра в реальном времени. Помимо базовых цветов и шрифтов, в разделе брендирования теперь доступны настройки прогресс-бара и работа с пресетами брендирования.

• Цвет фона страницы, цвет текста и основной шрифт
• Фон хедера, заголовок, шрифт заголовка, логотип и возможность полностью скрыть хедер
• Цвет фона прогресс-бара, цвет прогресса и высота полосы
• Цвета кнопок, цвета при наведении, шрифт текста кнопок, внутренние отступы и форма кнопок
• Оформление блока заголовка страницы, цвета таймера, стили вариантов ответов и иконки результата

Если в форме используется прогресс-бар, здесь можно настроить его внешний вид. Если он не нужен совсем, его можно полностью отключить в основных настройках формы.

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

Все изменения брендирования сразу отображаются в живом предпросмотре.

Интеграции внешних сервисов

В приложении доступны два основных сценария интеграций: вебхуки результатов и LMS / LTI-интеграции.

Вебхуки результатов

На уровне конкретной формы есть отдельная вкладка Вебхуки, где можно настроить автоматическую отправку результата после завершения прохождения пользователем.

То есть вебхуки в Askium работают по сценарию "форма завершена -> результат посчитан -> данные автоматически отправлены на ваш URL". Это удобно для передачи результатов во внутреннюю CRM, LMS, ERP, HR-систему или собственный сервер.

Для включения вебхуков на форме доступны такие настройки:

• Состояние — включает или отключает отправку вебхуков;
• URL адрес — полный адрес вашего endpoint, который будет принимать данные;
• Формат — формат отправки данных: JSON или XML;
• Авторизация — включает передачу дополнительного HTTP-заголовка;
• Заголовок (Header) — имя заголовка, например Authorization или X-Webhook-Token;
• Значение (Token) — значение заголовка, например Bearer your-secret-token.

Если авторизация включена и оба поля заполнены, система добавляет этот заголовок к HTTP-запросу вебхука. Если вебхуки отключены или URL не задан, отправка не выполняется. Для тарифа Basic функция недоступна.

Полезная нагрузка вебхука содержит пять основных частей:

• form — ключ, название и тип формы;
• result — ключ результата, дата начала и завершения;
• score — максимальные баллы, набранные баллы и процент правильных ответов;
• user — ключ пригласительной ссылки и персональные данные пользователя, если они были доступны;
• answers — список ответов с данными вопроса, текстом ответа и признаком корректности.

Если текст вопроса использует расширенный HTML-редактор, вместо исходного HTML в webhook-полезной нагрузке передаётся строка advanced_html.

{
  "form": {
    "id": "frm-php-exam",
    "name": "PHP Certification Exam",
    "type": "exam"
  },
  "result": {
    "id": "res-8f2d1a",
    "started_at": "2026-03-01 10:00:00",
    "finished_at": "2026-03-01 10:42:15"
  },
  "score": {
    "max_points": 50,
    "total_points": 42,
    "percent": 84
  },
  "user": {
    "link_id": "link-abc123",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com"
  },
  "answers": [
    {
      "question": {
        "id": "q-http-001",
        "title": "HTTP code",
        "text": "Which status code means success?"
      },
      "answer": "200 OK",
      "correct": true
    },
    {
      "question": {
        "id": "q-rich-002",
        "title": "Rich text question",
        "text": "advanced_html"
      },
      "answer": "Custom answer",
      "correct": false
    }
  ]
}

<result>
  <form>
    <id>frm-php-exam</id>
    <name>PHP Certification Exam</name>
    <type>exam</type>
  </form>
  <details>
    <id>res-8f2d1a</id>
    <started_at>2026-03-01 10:00:00</started_at>
    <finished_at>2026-03-01 10:42:15</finished_at>
  </details>
  <score>
    <max_points>50</max_points>
    <total_points>42</total_points>
    <percent>84</percent>
  </score>
  <user>
    <link_id>link-abc123</link_id>
    <first_name>John</first_name>
    <last_name>Doe</last_name>
    <email>john.doe@example.com</email>
  </user>
  <answers>
    <answer>
      <question>
        <id>q-http-001</id>
        <title>HTTP code</title>
        <text>Which status code means success?</text>
      </question>
      <answer_text>200 OK</answer_text>
      <correct>true</correct>
    </answer>
  </answers>
</result>

LMS / LTI-интеграции

Сценарий работы с LMS / LTI в приложении состоит из двух отдельных этапов, и это важно понимать:

• Сначала в меню пользователя создаётся и сохраняется сама LMS-интеграция как общее подключение к внешней платформе;
• Затем нужная форма отдельно привязывается к одной из уже сохранённых интеграций через экран привязок к интеграциям внутри этой формы.

То есть интеграция не создаётся «внутри формы». Сначала вы настраиваете общее подключение один раз, а затем можете переиспользовать его для одной или нескольких форм.

Шаг 1. Создание общей LMS-интеграции

Отдельный раздел Интеграции LMS в меню пользователя предназначен для сохранения подключений к внешним обучающим платформам. Для интеграции можно выбрать готовый пресет платформы или использовать пользовательскую конфигурацию.

Поддерживаются версии LTI 1.0 / 1.1, LTI 1.3 или одновременная настройка обеих версий для одной интеграции.

• Для LTI 1.0 / 1.1 указываются OAuth Consumer Key и OAuth Shared Key;
• Для LTI 1.3 указываются Platform ID / iss, Client ID, OIDC login initiation URL, Access token URL и JWKS endpoint URL;
• Для пресетов платформ часть URL может подставляться автоматически, а для пользовательской интеграции все значения вводятся вручную.

После сохранения интеграция появляется в вашем личном списке LMS-интеграций и становится доступной для последующей привязки к формам.

Шаг 2. Привязка формы к созданной интеграции

После того как интеграция уже создана, в нужной форме открывается отдельный экран Интеграции / Привязки к интеграциям. На нём отображается список интеграций, которые уже привязаны к этой форме, и кнопка добавления новой привязки.

При нажатии на добавление система показывает список ваших сохранённых LMS-интеграций и позволяет выбрать одну из них для привязки к текущей форме. Если интеграции ещё не созданы, в этом окне будет прямой переход в раздел Интеграции LMS для их предварительного создания.

Привязки доступны не для всех форм: этот экран используется для типов Викторина и Экзамен и недоступен для Опросника. Также сама работа с LMS / LTI-интеграциями требует тариф выше Basic.

Именно такая схема позволяет один раз создать подключение к LMS, а затем аккуратно переиспользовать его в нескольких формах без повторного ввода всех LTI-параметров.

API

В приложении есть отдельный раздел настроек API, предназначенный для безопасной работы с внешними системами и автоматизации через ваш приватный API-ключ.

В этом интерфейсе можно:

• включить или отключить доступ к API;
• сгенерировать новый приватный API-ключ;
• скопировать текущий ключ для использования во внешних системах;
• включить дополнительное ограничение по IP для API;
• указать единственный допустимый IP-адрес, с которого будут приниматься API-запросы.

Если доступ к API отключен, приватные API-маршруты перестанут работать. При генерации нового ключа предыдущий ключ следует считать недействительным и обновить его во всех подключенных системах.

Базовые правила работы с API

• Базовый URL: https://askium.org/api
• Авторизация для приватных маршрутов передаётся через заголовок Authorization: Bearer YOUR_PRIVATE_API_KEY
• Content-Type для запросов с телом: application/json
• Если в настройках API включено ограничение по IP, запросы будут приниматься только с указанного адреса
• Маршрут POST /api/results/verify является публичным и не требует приватного API-ключа, но принимает одноразовый короткоживущий verification_key

Список доступных маршрутов

• POST /api/forms/{form_key}/invitation-links — создать персональную пригласительную ссылку
• DELETE /api/forms/{form_key}/invitation-links/{link_key} — удалить пригласительную ссылку
• GET /api/forms/{form_key}/invitation-links/active — получить список активных неиспользованных ссылок
• POST /api/forms/{form_key}/questions/import — импортировать вопросы в форму
• POST /api/results/{result_key}/verification-key — выпустить одноразовый ключ верификации результата
• POST /api/results/verify — проверить результат по одноразовому ключу верификации

Ниже приведены примеры запросов, описание полей и структура основных ответов. Каждый блок можно раскрыть отдельно.

curl -X POST "https://askium.org/api/forms/exam-api-001/invitation-links" \
  -H "Authorization: Bearer YOUR_PRIVATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com"
  }'

{
  "status": "ok",
  "link": {
    "key": "link-abc123",
    "url": "https://askium.org/f/exam-api-001?t=link-abc123",
    "is_active": true
  },
  "ticket_questions_count": 2
}

curl -X DELETE "https://askium.org/api/forms/exam-api-001/invitation-links/link-abc123" \
  -H "Authorization: Bearer YOUR_PRIVATE_API_KEY"

{
  "status": "ok",
  "message": "Пригласительная ссылка удалена."
}

curl -X GET "https://askium.org/api/forms/exam-api-001/invitation-links/active" \
  -H "Authorization: Bearer YOUR_PRIVATE_API_KEY"

{
  "status": "ok",
  "links": [
    {
      "key": "link-active-unused",
      "url": "https://askium.org/f/exam-api-list-001?t=link-active-unused",
      "is_active": true,
      "first_name": "Alice",
      "last_name": "Green",
      "email": "alice@example.com",
      "created_at": "2026-03-01 10:00:00"
    }
  ]
}

curl -X POST "https://askium.org/api/forms/quiz-import-001/questions/import" \
  -H "Authorization: Bearer YOUR_PRIVATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "difficulty": "medium",
    "points_num": 2,
    "questions": [
      {
        "question_short_title": "HTTP code",
        "question": "Which status code means success?",
        "options": ["200 OK", "301", "404", "500"],
        "correct_index": 0
      },
      {
        "question_short_title": "TCP port",
        "question": "Which port is typically used by HTTPS?",
        "options": ["21", "25", "80", "443"],
        "correct_index": 3
      }
    ]
  }'

{
  "status": "ok",
  "message": "Вопросы успешно импортированы.",
  "imported_count": 2,
  "import_key": "imp_3f9b84d1"
}

curl -X POST "https://askium.org/api/results/res-8f2d1a/verification-key" \
  -H "Authorization: Bearer YOUR_PRIVATE_API_KEY"

{
  "verification_key": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "JWT",
  "expires_at": "2026-03-01 10:05:00",
  "ttl_seconds": 300
}

curl -X POST "https://askium.org/api/results/verify" \
  -H "Content-Type: application/json" \
  -d '{
    "verification_key": "YOUR_ONE_TIME_VERIFICATION_KEY"
  }'

{
  "key": "res-8f2d1a",
  "is_finished": true,
  "started_at": "2026-03-01 10:00:00",
  "finished_at": "2026-03-01 10:42:15",
  "created_at": "2026-03-01 10:00:00",
  "correct_percent": 84,
  "total_points": 42,
  "max_points": 50,
  "correct_answers": 2,
  "wrong_answers": 1,
  "answers_total": 3,
  "unchecked_answers": 1,
  "timer_expires_at": "2026-03-01 11:00:00",
  "is_terminated": false,
  "is_timer_up": false,
  "invitation_link_key": null,
  "personal_data": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com"
  },
  "unwanted_events_count": 1,
  "form": {
    "key": "frm-php-exam",
    "name": "PHP Certification Exam",
    "type": "exam",
    "locale": "ru"
  }
}

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

Контроль доступа по IP

Контроль доступа по IP — функция, доступная только для форматов "Викторина" и "Экзамен". Она позволяет ограничить доступ к форме определёнными IP-адресами или масками.
Если доступ к форме ограничен только по ссылкам-приглашениям, можно дополнительно задать IP-адрес или маску, действующую только для конкретного экзаменационного билета.

Для активации этой функции включите соответствующий переключатель в конфигурации формы: "Контроль доступа по IP"

На вкладке Контроль доступа по IP вам нужно будет добавить IP-адреса, которые должны получить доступ к форме.

Дополнительный персональный IP-адрес для каждой ссылки можно добавить непосредственно в настройках Пригласительной ссылки.

Рабочие группы

Рабочая группа — это пространство для совместной работы с формами и результатами. Она позволяет не передавать форму другому владельцу, а дать доступ участникам команды только к тем разделам, которые действительно нужны для работы.

В каждой рабочей группе есть:

• Администратор — пользователь, который создал рабочую группу и является её владельцем. Может:
  • Приглашать и исключать участников
  • Настраивать индивидуальные права каждого участника
  • Выбирать формы, которые будут доступны группе
  • Включать или отключать рабочую группу
  • Удалять группу при необходимости
• Участники — пользователи, которых пригласил Администратор. Могут:
  • Работать с формами, которые администратор сделал доступными, в рамках назначенных прав
  • Включить или отключить настройку «Делиться контактами» — решение принимает каждый участник самостоятельно
  • Покинуть группу в любой момент

Индивидуальные права участника

Администратор может гибко настраивать, какие действия доступны каждому участнику.
Список доступных прав:

• Конфигурация формы — изменение основных настроек формы;
• Настройки сложности — управление распределением уровней сложности вопросов;
• Работа с вопросами — создание, редактирование и удаление вопросов формы;
• Работа со ссылками — управление ссылками-приглашениями;
• Просмотр результатов — просмотр всех результатов прохождения формы;
• Просмотр аналитики — доступ к статистике и аналитическим данным формы;
• Настройка интеграций — управление подключениями к LMS, webhook’ам и другим интеграциям;
• Стилизация и брендирование — настройка дизайна формы (цвета, логотип, шрифты);

Доступ к формам

Чтобы добавить форму в рабочую группу, в основной конфигурации формы выберите пункт «Рабочая группа» и укажите нужную группу.

После сохранения формы все участники группы увидят её на странице доступных групп, в отдельном списке, сгруппированном по названию группы.

Открыв форму, участник увидит только те разделы меню, доступ к которым ему предоставил администратор.

Меню пользователя

Для вызова меню пользователя нужно нажать на иконку с инициалами пользователя в правом верхнем углу интерфейса. В данном меню доступен ряд пунктов:

• Мои формы — перейти к вашему списку форм;
• Мои приглашения — перейти к интерфейсу клиента, где будут находится приглашения на заполнение форм адресованные вам;
• Аккаунт — страница настроек аккаунта;
• Настройки — страница настроек приложения;
• Выход — выйти из приложения, для повторного входа будет нужна авторизация;

Настройки аккаунта

На страницу настроек аккаунта можно попасть вызвав меню пользователя в правом верхнем углу экрана и выбрав пункт пеню "Аккаунт".

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

Настройки приложения

На страницу настроек аккаунта можно попасть, вызвав меню пользователя в правом верхнем углу экрана и выбрав пункт пеню "Настройки".

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

Интерфейс для клиентов

Тут отображаются приглашения на заполнение форм адресованные вам. Для того чтобы приглашение отобразилось в этом списке нужно чтобы в пригласительной ссылке был указан Email идентичный тому что указан в вашем аккаунте (его можно увидеть на странице Настройки аккаунта в разделе персональных данных).

Перед началом прохождения пользователь видит вводную страницу формы. На ней могут отображаться предупреждения о таймере, невозможности вернуться к предыдущим вопросам или страницам, мониторинге действий и других ограничениях текущей формы.

Если для экзамена включён прокторинг через веб-камеру, на стартовой странице дополнительно появится проверка камеры перед началом. Пользователь должен разрешить доступ к камере и пройти pre-check. Только после успешной проверки станет доступен запуск экзамена.