Dokumentace

Formuláře

V rozhraní „Moje formuláře“ se zobrazuje aktuální seznam vašich formulářů. Každý formulář je prezentován blokem obsahujícím název, stručný přehled nastavení a popis.

Kliknutím na blok formuláře přejdete do rozhraní práce s tímto konkrétním formulářem.

Souhrn formuláře

Na kartě „Detaily“ se zobrazuje stručný souhrn nastavení, počet otázek, počet dokončených výsledků, aktuální stav a další.
Nachází se zde také přepínač publikace (Publikovat/Stáhnout z publikace).

Otázky

Na kartě „Otázky“ se zobrazuje seznam již přidaných otázek.
Každá otázka je blok se stručným přehledem nastavení a tlačítky Upravit a Smazat.
Pokud je „Rozdělení na stránky“ nastaveno na „Pro více otázek“, je dostupné tlačítko „Přidat stránku“ pro rozdělení otázek.
Vlevo u každé otázky je „kotva“ , za kterou lze otázky přetahovat a měnit pořadí nebo stránku.
Novou otázku přidáte tlačítkem „Přidat otázku“ v horní části. Otevře se panel konfigurace, kde nastavíte popis, odpovědi apod.

Kromě ručního přidávání jsou k dispozici i další způsoby práce s bankou otázek:
Import otázek — samostatné rozhraní importu umožňuje nahrát otázky z JSON souboru nebo vložit JSON ručně. Během importu lze rovnou nastavit i společné parametry, například úroveň obtížnosti a počet bodů, pokud se na aktuální formulář vztahují.
AskiumAI — generátor otázek založený na AI dokáže automaticky vytvořit sadu otázek s možnostmi odpovědí podle tématu, obtížnosti a dalších parametrů. Vygenerované otázky se přidají do aktuálního formuláře.

Na stránce Import otázek jsou k dispozici dvě pomocné akce: "Příklad očekávaného formátu JSON" a "Příklad promptu pro generování pomocí AI". Druhá z nich otevře připravenou šablonu promptu, do které můžete doplnit téma, počet otázek, počet možností odpovědi, obtížnost a jazyk generování a poté ji zkopírovat pro použití v externí AI službě.

Import podporuje nejen nahrání lokálního JSON souboru, ale i ruční vložení raw JSON. Pokud byl JSON vygenerován pomocí AI, můžete vložit jak čistý JSON, tak celý json code block z odpovědi modelu. Po spuštění se import provádí jako úloha na pozadí: stránka zobrazuje stav zpracování a po úspěšném dokončení otevře seznam importovaných otázek.

Rozhraní importu je dostupné pouze pro formuláře typu Kvíz a Zkouška a jen v tarifech Plus nebo Pro. Pokud je ve formuláři zapnutý bodový systém, lze při běžném importu ručně nastavit jednu společnou hodnotu bodů, zatímco u zkoušky s aktivním Systémem obtížnosti se body pro importované otázky přiřazují automaticky podle zvolené obtížnosti.

Konfigurace otázky

K dispozici je řada nastavení určujících, jak uživatel odpoví a jak odpověď ovlivní výsledek.
Dostupnost některých nastavení závisí na jiných a mohou se navzájem vylučovat.

Úplný seznam nastavení otázky:

• Název — název otázky viditelný pouze vám v rozhraní a seznamu otázek formuláře/lístku. Doporučeno stručně (2–3 slova). Povinné.
• Popis — popis otázky zobrazený uživatelům ve formuláři/testu/zkoušce. Povinné.
  Pro tarify „Plus“ nebo „Pro“ je dostupný rozšířený editor se složitým formátováním (velikost, barva, styl písma, seznamy, obrázky, video, kód se zvýrazněním či matematické vzorce).
• Přeskočitelná — určuje, zda lze otázku přeskočit.
  Pokud je „Rozdělení na stránky“ nastaveno na „Pro jednu otázku“, bude dostupné tlačítko „Přeskočit“.
• Typ odpovědi — hlavní nastavení otázky určující způsob odpovědi:
  • Seznam možností — uživatel vybere jednu či více nabízených možností. Můžete povolit vlastní možnost nebo označit správné/nesprávné.
  • Vstupní pole — uživatel zadá odpověď do pole, jeho typ se nastavuje níže.
  • Výběr data — uživatel vybere datum v kalendáři.
  • Rozsah — uživatel nastaví hodnotu posuvníkem, hodnota se mění okamžitě.
  • Hodnocení — řada symbolů (obvykle hvězdy), kliknutím se nastaví hodnota dle pořadí symbolu.
  • Osobní údaje — speciální typ pro jméno, příjmení a e-mail. Pomáhá orientovat se v seznamech výsledků.
• Typ seznamu možností — podnastavení Seznamu možností, kolik možností lze vybrat:
  • Jedna možnost — lze vybrat pouze jednu.
  • Více možností — lze vybrat jednu i více.
• Správnost — podnastavení Seznamu možností určující, zda se možnosti dělí na správné a nesprávné.
• Vlastní odpověď — podnastavení Seznamu možností dovolující zadat vlastní možnost. Nedostupné, pokud je zapnuta Správnost.
• Úroveň obtížnosti — podnastavení Seznamu možností při typu „Zkouška“ a zapnutém Systému obtížnosti, určující skupinu obtížnosti otázky. Povinné.
• Možnosti odpovědí — podnastavení Seznamu možností, seznam možností k výběru. Novou možnost přidáte tlačítkem „Přidat možnost“; přidá se na konec.
  Každou možnost lze přesouvat a mazat.
  Pokud je zapnuta Správnost, lze u každé možnosti označit Správnou. U Více možností může být správných více, ale alespoň jedna.
• Typ pole — podnastavení Vstupního pole, určující typ a povolená data. K dispozici je 5 typů:
  • Jeden řádek — běžné textové pole bez zalomení.
  • Více řádků — textové pole s možností zalomení.
  • Číslo — pouze celá čísla.
  • Desetinné číslo — celá i desetinná čísla.
  • Email — pole pro e-mail.
• Typ osobních údajů — podnastavení Osobních údajů, určující očekávaná data:
  • Jméno
  • Příjmení
  • Email
• Min. délka — podnastavení Vstupního pole pro typy Jeden řádek nebo Více řádků, minimální povolená délka řetězce. Pouze celé číslo ≥ 0. Nepovinné.
• Max. délka — podnastavení Vstupního pole pro typy Jeden řádek nebo Více řádků, maximální povolená délka řetězce. Pouze celé číslo ≥ 0. Nepovinné.
• Počet řádků default — podnastavení pro Více řádků, výchozí výška pole ve řádcích. Pouze celé číslo ≥ 1. Nepovinné.
• Min — podnastavení pro Číslo/Desetinné číslo, minimální povolená hodnota. Pouze celé číslo. Nepovinné.
• Max — podnastavení pro Číslo/Desetinné číslo, maximální povolená hodnota. Pouze celé číslo. Nepovinné.
• Krok — podnastavení pro Číslo/Desetinné číslo, určuje násobek, kterému má hodnota odpovídat. Pouze celé číslo. Nepovinné.

Specifika Zkoušky

U typu „Zkouška“ je typ otázky vždy „Seznam možností“ a nelze jej změnit. Nelze vypnout Správnost ani zapnout Vlastní odpověď, proto jsou tyto ovladače skryté.

Import otázek

Stránku importu lze otevřít ze sekce otázek aktuálního formuláře. Je dostupná pouze pro formuláře typu Kvíz a Zkouška a jen v tarifech Plus nebo Pro. V rozhraní můžete zvolit jednu společnou úroveň obtížnosti pro všechny importované otázky a, pokud aktuální formulář používá bodovací systém mimo režim obtížnosti zkoušky, také ručně nastavit jednu společnou bodovou hodnotu.

Na stránce jsou zabudované dvě pomocné akce: "Příklad očekávaného formátu JSON" a "Příklad promptu pro generování přes AI". První ukazuje přesný JSON kontrakt s klíči question_short_title, question, options a correct_index. Druhá otevře hotovou šablonu promptu, do které můžete doplnit téma, počet otázek, počet možností odpovědi, obtížnost a jazyk, a poté ji zkopírovat pro použití v externí AI službě.

{
  "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
    }
  ]
}

Otázky lze importovat dvěma způsoby: nahráním lokálního JSON souboru nebo ručním vložením zdrojového raw JSON. Pokud byl obsah vygenerován AI modelem, stránka přijímá také celý json code block z odpovědi. Po odeslání běží import jako úloha na pozadí: stránka automaticky kontroluje stav úlohy a po úspěšném dokončení otevře seznam importovaných otázek pro kontrolu a další úpravy.

Pokud je formulář zkouškou se zapnutým Systémem obtížnosti, body za importované otázky se přidělují automaticky podle vybrané úrovně obtížnosti. Stejný importní postup tak zůstává kompatibilní jak s kvízy s ručním bodováním, tak se zkouškami vyváženými podle obtížnosti.

AskiumAI: generátor otázek

AskiumAI je samostatná stránka pro generování otázek přímo v aktuálním formuláři. Rozhraní zobrazuje váš aktuální zůstatek AI tokenů a pomáhá plnit banku otázek bez opuštění aplikace. Generování otázek je dostupné pouze pro formuláře typu Kvíz a Zkouška; u ostatních typů formulářů rozhraní zobrazí upozornění a neumožní spuštění úlohy.

Na stránce generátoru nastavujete oblast / téma, obtížnost, počet otázek a počet možností odpovědi. Pokud formulář používá bodovací systém mimo režim obtížnosti zkoušky, můžete také určit počet bodů za správnou odpověď. Jazyk generovaných otázek vychází z lokalizace nastavené pro samotný formulář, nikoli z aktuálního jazyka rozhraní.

Po odeslání AskiumAI nejprve zkontroluje téma a poté spustí generování jako úlohu na pozadí. Stránka zobrazuje průběžné stavy, automaticky dotazuje stav úlohy a po úspěchu otevře seznam vygenerovaných otázek. Vygenerované otázky i možnosti odpovědí je vždy potřeba před publikací ručně zkontrolovat, protože AI stále může chybovat.

Po dokončení generování lze výsledné otázky projít, upravit, částečně odstranit nebo ponechat jen vybrané před dalším pokračováním práce s formulářem.

Nastavení obtížnosti

Pokud je typ „Zkouška“ a je zapnut „Systém obtížnosti“, je dostupná karta „Nastavení obtížnosti“.
Na této kartě nastavíte průměrnou obtížnost zkouškového lístku.
Uvedete, kolik otázek které obtížnosti má být v každém lístku. Celkem je 5 úrovní obtížnosti:

• Velmi snadná
• Snadná
• Střední
• Obtížná
• Velmi obtížná

Při automatickém generování lístků se bere vámi uvedený počet otázek dané obtížnosti, ale v náhodném pořadí. Celková obtížnost tak bude vyvážená, ale každém lístek unikátní.

Můžete si vybrat, které úrovně použijete; celý rozsah není povinný. Obvykle se používají 2–3 úrovně, např. od Snadné po Obtížnou.

Pokud je zapnut „Bodovací systém“, lze na této kartě nastavit body pro jednotlivé úrovně obtížnosti, protože v kombinaci s „Systémem obtížnosti“ už nelze body přiřazovat jednotlivým otázkám.

Pozvánkové odkazy

Tato karta je dostupná, pokud je v konfiguraci formuláře zapnut „Přístup — Pouze na pozvání“.

Na kartě „Pozvánkové odkazy“ se ve výchozím stavu zobrazuje aktuální seznam aktivních pozvánek.
Každá pozvánka je blok s obecnými informacemi:

• Plná URL odkazu
• Jméno a příjmení pozvaného uživatele, pokud jsou uvedeny
• E-mail pozvaného uživatele, pokud je uveden
• Počet otázek ve zkouškovém lístku, pokud je typ — Zkouška

Každý blok obsahuje přepínač zapnutí/vypnutí a sadu tlačítek:

• Tlačítko odeslání pozvánky e-mailem (je-li e-mail uveden); nedostupné, pokud již byla odeslána, použita nebo vypnuta;
• Tlačítko kopírování URL do schránky; nedostupné, je-li odkaz vypnut;
• Tlačítko „Sdílet“ do sociálních sítí, messengerů, e-mailem apod.; nedostupné, je-li odkaz již použit nebo vypnut;
• Tlačítko generování QR kódu s odkazem; nedostupné, je-li odkaz vypnut;
• Tlačítko úpravy odkazu; nedostupné, je-li odkaz již použit;
• Tlačítko smazání odkazu; nedostupné, je-li odkaz již použit;
• Tlačítko přejít na výsledky uživatele; dostupné až po použití odkazu;

Kliknutím na blok pozvánky přejdete do rozhraní práce s tímto konkrétním odkazem.

Novou pozvánku přidáte tlačítkem „Přidat“, poté přejdete do rozhraní jejího vytvoření.

Vytvoření pozvánky

Při vytváření nové pozvánky jsou dostupná tato pole:

• Jméno
• Příjmení
• Email

Žádné pole není povinné — lze je nechat prázdná, avšak pro snadnější identifikaci výsledků doporučujeme tyto údaje vyplnit. Jinak bude identifikace ztížená.

Při vytvoření pozvánky se každé přidělí unikátní klíč, který je přidán do URL. Pokud pozvánka zůstane anonymní (bez jména/příjmení/e-mailu), jediným identifikátorem je unikátní klíč.

Pokud jsou vaši uživatelé (klienti/zaměstnanci/studenti/...) stálí, můžete jejich údaje ukládat do seznamu kontaktů tlačítkem „Uložit kontakt“, případně je z něj importovat tlačítkem „Import“ výběrem daného kontaktu.

Pokud je typ „Zkouška“, po vytvoření pozvánky rovnou přejdete do rozhraní práce s ní za účelem naplnění zkouškového lístku otázkami (původně je prázdný).

Úprava pozvánky

Rozhraní úprav je podobné vytvoření, navíc obsahuje přepínač stavu (zapnuto/vypnuto) a zobrazí se unikátní klíč.

Zkouškový lístek

Pokud je typ „Zkouška“, je v rozhraní úprav pozvánky k dispozici i část pro práci se zkouškovým lístkem a jeho naplněním otázkami.
Lístek lze naplnit dvěma způsoby:

• Kliknutím na „Vygenerovat lístek“ — lístek se okamžitě naplní otázkami dle nastavení obtížnosti (pokud je zapnut Systém obtížnosti, nastavení je vyplněno a ve formuláři je dostatek otázek daných úrovní).
• Ručním výběrem — tlačítkem „Přidat otázku“ a výběrem z listu (lze více najednou).

V naplněném lístku lze měnit pořadí přetahováním za kotvu a otázky mazat.

U typu „Zkouška“ nelze aktivovat pozvánku, jejíž lístek neobsahuje otázky.

Seznam kontaktů

Tato karta je dostupná, pokud je v konfiguraci formuláře zapnut „Přístup — Pouze na pozvání“.

Zobrazuje se zde seznam kontaktů vašich uživatelů (klientů/zaměstnanců/studentů/...). Slouží k následnému importu údajů (jméno, příjmení, e-mail) do pozvánek, čímž se jejich vytváření zjednoduší.

Nový kontakt přidáte tlačítkem „Přidat“, poté přejdete do rozhraní jeho vytvoření.

Každý kontakt má 3 pole:

• Jméno
• Příjmení
• Email

Pro uložení kontaktu je nutné vyplnit všechna pole. E-maily v seznamu kontaktů se nesmí opakovat.

Výsledky

Na této kartě se zobrazuje seznam výsledků vyplnění formuláře. Každý výsledek je blok se stručnými informacemi:

• Klíč — unikátní klíč každého výsledku;
• Stav — Probíhá nebo Dokončeno;
• Datum a čas dokončení vyplnění;
• Jméno a příjmení uživatele, pokud je zapnut přístup pouze na pozvání a ve pozvánce byly uvedeny;
• Email uživatele, pokud je zapnut přístup pouze na pozvání a ve pozvánce byl uveden;
• Body získané v tomto výsledku, pokud je zapnut Bodovací systém;
• Procenta % správných odpovědí, pokud je typ Kvíz nebo Zkouška;

Kliknutím na blok výsledku přejdete na stránku s detailními informacemi:

• Obecný souhrn;
• Protokol nežádoucích akcí (pokud byl zapnut Monitoring akcí);
• Úplný seznam odpovědí na otázky, včetně správnosti, pokud existuje;

Analytika

Na kartě Analytika se zobrazuje celkový souhrn všech výsledků za celou dobu existence formuláře.

Jsou zde k dispozici následující informace:

• Grafy vyplňování — grafy zobrazující dynamiku vyplňování:
  • Denní graf — kolikrát byl formulář vyplněn za posledních 30 dní.
  • Měsíční graf — kolikrát byl formulář vyplněn za posledních 12 měsíců.
• Statistika výsledků — agregovaná statistika za celé období:
  • Celkový počet výsledků
  • Celkový počet bodů ve formuláři
  • Průměrný počet bodů získaný uživateli
  • Maximální počet bodů získaný uživateli
  • Minimální počet bodů získaný uživateli
  • Průměrné procento správných odpovědí
  • Maximální procento správných odpovědí
  • Minimální procento správných odpovědí
• Statistika otázek — agregovaná statistika pro každou otázku zvlášť.
  U výběrových otázek:
  • Počet a relativní procento přeskočení otázky;
  • Počet a relativní procento správných odpovědí;
  • Srovnávací statistická tabulka pro každou možnost odpovědi;
  • Srovnávací graf pro každou možnost odpovědi;
  
  U číselného vstupu:
  • Počet a relativní procento přeskočení otázky;
  • Průměrná hodnota odpovědi;
  • Maximální hodnota odpovědi;
  • Minimální hodnota odpovědi;
  
  U textového nebo datového vstupu — úplný seznam odpovědí.

Analytiku lze také exportovat do PDF a Excelu. Export se připravuje na pozadí a poté je vygenerovaný soubor dostupný ke stažení.

Branding a stylizace

Na této kartě můžete nastavovat vizuální styl formuláře v režimu živého náhledu. Kromě základních barev a písem nyní sekce brandingu zahrnuje také nastavení ukazatele průběhu a práci s presety brandingu.

• Barvu pozadí stránky, barvu textu a hlavní písmo
• Pozadí headeru, nadpis, písmo nadpisu, logo a možnost header úplně skrýt
• Barvu podkladu ukazatele průběhu, barvu vyplnění a výšku lišty
• Barvy tlačítek, hover barvy, písmo textu tlačítek, vnitřní odsazení a tvar tlačítek
• Styl bloku názvu stránky, barvy časovače, styl variant odpovědí a ikony výsledku

Pokud formulář používá ukazatel průběhu, můžete zde upravit jeho vzhled. Pokud jej nechcete zobrazovat vůbec, lze jej úplně vypnout v hlavním nastavení formuláře.

Můžete také uložit aktuální stylizaci jako preset brandingu a později načíst existující preset do jiného formuláře. To je užitečné, pokud chcete stejný vizuální styl opakovaně použít ve více formulářích.

Všechny změny brandingu se okamžitě zobrazují v živém náhledu.

Integrace externích služeb

V Askium jsou aktuálně k dispozici dva hlavní scénáře integrace: výsledkové webhooky a LMS / LTI integrace.

Webhooky výsledků

Na kartě integrací formuláře můžete zapnout automatické odesílání dat o dokončeném výsledku do externího systému. Odeslání proběhne po dokončení formuláře uživatelem.

Tato funkce se nastavuje na samostatné kartě Webhooks a je dostupná pro placené tarify vyšší než Basic.

V nastavení webhooku jsou k dispozici tyto položky:

• Status — zapnutí nebo vypnutí odesílání;
• URL address — plná adresa endpointu, na který Askium odešle data;
• Format — formát payloadu: JSON nebo XML;
• Authorization — zda se má přidat autorizační hlavička;
• Header — název hlavičky, například Authorization nebo X-Webhook-Token;
• Value — hodnota hlavičky nebo tokenu, která bude posílána s požadavkem.

Payload může obsahovat bloky form, result, score, user a answers. Pokud otázka používá pokročilý HTML editor, text otázky se odesílá v poli advanced_html.

{
  "form": {
    "id": "quiz-http-001",
    "title": "HTTP Basics"
  },
  "result": {
    "id": "res-8f2d1a",
    "completed_at": "2026-04-11T09:15:00Z"
  },
  "score": {
    "points": 8,
    "max_points": 10,
    "correct_answers": 4,
    "total_questions": 5
  },
  "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",
        "advanced_html": "<p>Which status code means success?</p>"
      },
      "answer_text": "200 OK",
      "correct": true
    }
  ]
}

<result>
  <form>
    <id>quiz-http-001</id>
    <title>HTTP Basics</title>
  </form>
  <result_meta>
    <id>res-8f2d1a</id>
    <completed_at>2026-04-11T09:15:00Z</completed_at>
  </result_meta>
  <score>
    <points>8</points>
    <max_points>10</max_points>
    <correct_answers>4</correct_answers>
    <total_questions>5</total_questions>
  </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 integrace

Proces LMS / LTI se skládá ze dvou samostatných kroků: nejprve se v uživatelském menu vytvoří sdílená LMS integrace a teprve potom se konkrétní formulář naváže na existující integraci přes obrazovku vazeb integrací.

Integrace se tedy nevytváří „uvnitř formuláře“. Nakonfiguruje se jednou a následně ji lze použít ve více formulářích.

• Pro LTI 1.0 / 1.1 se vyplňuje OAuth Consumer Key a OAuth Shared Key;
• Pro LTI 1.3 se vyplňuje Platform ID / iss, Client ID, OIDC login initiation URL, Access token URL a JWKS endpoint URL.

Obrazovka vazeb je dostupná pro Kvíz a Zkoušku, nikoli pro Dotazník, a vyžaduje tarif vyšší než Basic.

API

Aplikace obsahuje samostatnou sekci nastavení API, určenou pro bezpečnou práci s externími systémy a automatizací pomocí soukromého API klíče.

• zapnutí a vypnutí přístupu k API;
• generování nového soukromého API klíče;
• kopírování aktuálního klíče;
• zapnutí dodatečného omezení podle IP;
• nastavení jediné povolené IP adresy.

Základní pravidla API

• Base URL: https://askium.org/api
• Authorization: Authorization: Bearer YOUR_PRIVATE_API_KEY
• Content-Type: application/json
• Pokud je zapnuto omezení podle IP, požadavky budou přijímány pouze z povolené adresy
• POST /api/results/verify je veřejná trasa a nevyžaduje soukromý API klíč

Dostupné trasy

• 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": "Invitation link deleted."
}

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": "Otázky byly úspěšně importovány.",
  "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": "cs"
  }
}

API and LTI integration assets

Use these machine-readable files and discovery endpoints when evaluating or wiring Askium into an LMS, CRM, HR system, or internal automation stack.

LTI discovery endpoints

The LMS integration flow exposes standard LTI 1.1 cartridge and LTI 1.3 discovery URLs.

• https://askium.org/lti/1_1/config — LTI 1.1 cartridge configuration
• https://askium.org/.well-known/openid-configuration — LTI 1.3 OpenID configuration
• https://askium.org/.well-known/jwks — public JWKS for LTI 1.3 launches
• https://askium.org/lti/1_3/register — dynamic registration endpoint when a platform supports it

Kontrola přístupu podle IP

Kontrola přístupu podle IP je funkce dostupná pouze pro formáty "Kvíz" a "Zkouška". Umožňuje omezit přístup k formuláři na určité IP adresy nebo masky.
Pokud je přístup k formuláři omezen pouze prostřednictvím odkazů s pozvánkou, můžete navíc zadat IP adresu nebo masku, která platí pouze pro konkrétní zkouškový lístek.

Pro aktivaci této funkce zapněte příslušný přepínač v konfiguraci formuláře: "Kontrola přístupu podle IP"

Na kartě Kontrola přístupu podle IP budete muset přidat IP adresy, které mají mít přístup k formuláři.

Další osobní IP adresu pro každý odkaz lze přidat přímo v nastavení Odkazu s pozvánkou.

Pracovní skupiny

Pracovní skupina je prostor pro týmovou práci s formuláři a výsledky. V každé pracovní skupině jsou:

• Administrátor — uživatel, který skupinu vytvořil a je jejím vlastníkem. Může:
  • Zvat a vylučovat účastníky
  • Nastavovat individuální oprávnění každého účastníka
  • Volit formuláře dostupné skupině
  • Skupinu zapínat nebo vypínat
  • Dle potřeby skupinu smazat
• Účastníci — uživatelé pozvaní Administrátorem. Mohou:
  • Pracovat s formuláři zpřístupněnými administrátorem v rámci přidělených práv
  • Zapnout či vypnout nastavení „Sdílet kontakty“ — rozhoduje každý účastník sám
  • Skupinu kdykoli opustit

Individuální práva účastníka

Administrátor může flexibilně nastavit, jaké akce má každý účastník k dispozici.
Seznam práv:

• Konfigurace formuláře — změna základních nastavení formuláře;
• Nastavení obtížnosti — správa rozdělení úrovní obtížnosti otázek;
• Práce s otázkami — vytváření, úprava a mazání otázek;
• Práce s odkazy — správa pozvánkových odkazů;
• Zobrazení výsledků — přístup ke všem výsledkům formuláře;
• Zobrazení analytiky — přístup ke statistikám a analytickým datům;
• Nastavení integrací — správa napojení na LMS, webhooky a další integrace;
• Stylizace a branding — nastavení designu formuláře (barvy, logo, písma);

Přístup k formulářům

Chcete-li přidat formulář do pracovní skupiny, v hlavní konfiguraci formuláře zvolte „Pracovní skupina“ a vyberte požadovanou skupinu.

Po uložení uvidí všichni účastníci skupiny formulář na stránce dostupných skupin v samostatném seznamu seskupeném podle názvu skupiny.

Po otevření formuláře uvidí účastník pouze ty části menu, ke kterým mu administrátor udělil přístup.

Uživatelské menu

Uživatelské menu otevřete kliknutím na ikonu s iniciálami vpravo nahoře. Menu obsahuje:

• Moje formuláře — přechod na seznam formulářů;
• Moje pozvánky — přechod do klientského rozhraní se seznamem pozvánek adresovaných vám;
• Účet — stránka nastavení účtu;
• Nastavení — stránka nastavení aplikace;
• Odhlásit se — odhlášení z aplikace; pro další vstup je potřeba přihlášení;

Nastavení účtu

Na stránku nastavení účtu se dostanete z Uživatelského menu vpravo nahoře výběrem položky „Účet“.

Zobrazují se zde vaše osobní údaje, připojené sociální sítě, aktivní tarif předplatného a rozhraní pro změnu hesla.

Nastavení aplikace

Na stránku nastavení aplikace se dostanete z Uživatelského menu výběrem položky „Nastavení“.

Zde lze nastavit jazyk rozhraní aplikace a přepínat mezi světlým a tmavým motivem.

Rozhraní pro klienty

Zde se zobrazují pozvánky k vyplnění formulářů adresované vám. Aby se pozvánka zobrazila v tomto seznamu, musí být ve pozvánkovém odkazu uveden e-mail totožný s tím ve vašem účtu (viz Nastavení účtu v části osobních údajů).