Spørsmålsbilder

Trenger du en tallrekke med et tomt felt, en setning med et hull, eller et kodeutdrag der én bit mangler? Disse malene tegner det bildet på samme måte hver gang.

Be om et bilde

Send en mal og litt data. Samme inndata tegner alltid det samme bildet.

HTTP

POST /api/v1/quizzes/{quizId}/images/templates
Authorization: Bearer <quiz-scoped-key>
Content-Type: application/json

{
  "templateId": "universal.tiles",
  "data": {
    "rows": [
      [
        "2",
        "4",
        "8",
        "?"
      ]
    ]
  }
}

Behold det, eller bare se på det

Lagre bildet med quizen, eller be om en midlertidig forhåndsvisning mens du finpusser.

output: "image"

Det vanlige resultatet er et WebP lagret med quizen, returnert som et bilde-id.

output: "png" | "svg"

PNG og SVG kommer tilbake som forhåndsvisning og lagres ikke.

Maler med et synlig hull

Dette er de som faktisk viser et tomt felt å fylle inn.

language.textCloud og code.syntaxBlock gir kontekst, men tegner ikke et hull, så de bor i API-referansen i stedet for i dette galleriet.

universal.tiles

Tallbrikker

Rekker, summer og likninger lagt opp som tydelige brikker.

JSON

{
  "templateId": "universal.tiles",
  "data": {
    "rows": [
      [
        "2",
        "4",
        "8",
        "?"
      ]
    ]
  }
}

universal.sortingBins

Sorteringskasser

Legg ting i merkede kategorier.

JSON

{
  "templateId": "universal.sortingBins",
  "data": {
    "bins": [
      "Round",
      "Angular"
    ],
    "binItems": [
      [
        {
          "kind": "shape",
          "name": "circle"
        },
        {
          "kind": "shape",
          "name": "triangle"
        }
      ],
      [
        {
          "kind": "shape",
          "name": "circle"
        },
        "?"
      ]
    ]
  }
}

universal.clockFace

Urskive

En analog klokke for spørsmål om klokka.

JSON

{
  "templateId": "universal.clockFace",
  "data": {
    "hour": 3,
    "minute": 30
  }
}

universal.numberLine

Tallinje

Telling og tallfølger med valgfri blank rute.

JSON

{
  "templateId": "universal.numberLine",
  "data": {
    "start": 0,
    "end": 10,
    "step": 2,
    "missing": 6
  }
}

math.fractionBar

Brøkstolpe

En oppdelt stolpe som viser en brøkdel av en helhet.

JSON

{
  "templateId": "math.fractionBar",
  "data": {
    "shaded": 3,
    "total": 4
  }
}

language.sentenceTiles

Setningsbrikker

En setning av ordbrikker, med et hull å fylle.

JSON

{
  "templateId": "language.sentenceTiles",
  "data": {
    "words": [
      "The",
      "cat",
      "sat",
      "on",
      "the",
      {
        "kind": "gap",
        "characters": 3
      }
    ]
  }
}

geometry.figure

Geometrisk figur

Vinkler, trekanter, firkanter, sirkler og parallelle linjer med merkelappene oppgaven trenger og et tomt felt for det ukjente.

JSON

{
  "templateId": "geometry.figure",
  "data": {
    "kind": "triangle",
    "angles": [
      90,
      35,
      55
    ],
    "angleLabels": [
      "90°",
      "35°",
      "?"
    ],
    "sideLabels": [
      "12 cm",
      null,
      "5 cm"
    ],
    "vertices": [
      "A",
      "B",
      "C"
    ]
  }
}

data.barChart

Søylediagram

Les av verdier på rutenettet, sammenlign kategorier eller finn en sum.

JSON

{
  "templateId": "data.barChart",
  "data": {
    "title": "Costumes worn at the party",
    "categories": [
      "Witch",
      "Ghost",
      "Vampire",
      "Zombie"
    ],
    "values": [
      12,
      7,
      9,
      4
    ],
    "unit": "pupils"
  }
}

data.table

Datatabell

En liten tabell med én skjult celle for spørsmål av typen «hva skal stå her?».

JSON

{
  "templateId": "data.table",
  "data": {
    "headers": [
      "Shop",
      "Price (£)",
      "Sold"
    ],
    "rows": [
      [
        "Boo",
        3.5,
        12
      ],
      [
        "Fang",
        4,
        null
      ],
      [
        "Grim",
        2.75,
        20
      ]
    ]
  }
}

math.coordinateGrid

Koordinatsystem

Avmerkede punkter og linjestykker for koordinater, midtpunkter og stigningstall.

JSON

{
  "templateId": "math.coordinateGrid",
  "data": {
    "xMin": -5,
    "xMax": 5,
    "yMin": -5,
    "yMax": 5,
    "points": [
      {
        "x": 2,
        "y": 3,
        "label": "A"
      },
      {
        "x": -4,
        "y": 1,
        "label": "B"
      }
    ],
    "segments": [
      [
        0,
        1
      ]
    ]
  }
}

science.circuit

Kretsskjema

En seriekrets tegnet med standardsymboler: batteri, lyspære, motstand, bryter, målere.

JSON

{
  "templateId": "science.circuit",
  "data": {
    "components": [
      {
        "kind": "battery",
        "label": "6 V"
      },
      {
        "kind": "switch",
        "open": true
      },
      {
        "kind": "bulb",
        "label": "L1"
      },
      {
        "kind": "resistor",
        "label": "10 Ω"
      },
      {
        "kind": "ammeter"
      }
    ]
  }
}

science.rayDiagram

Strålediagram

Speil og linser med hovedstrålene; spør hvor bildet dannes, eller vis det.

JSON

{
  "templateId": "science.rayDiagram",
  "data": {
    "device": "concaveMirror",
    "focalLength": 2,
    "objectDistance": 5,
    "objectHeight": 2,
    "showImage": false
  }
}

code.fillBlank

Fyll inn det tomme feltet

Kode der den manglende biten er tydelig merket.

JSON

{
  "templateId": "code.fillBlank",
  "data": {
    "code": "function average(scores) {\n  const total = scores.reduce(\n    (sum, score) => sum + score,\n    0\n  )\n  return total ___{1} scores.length\n}",
    "language": "javascript"
  }
}

Flere kodeeksempler

code.fillBlank kan romme opptil 2 000 tegn fordelt på 30 linjer. Et bart ___ bruker standardbredden. ___{N} setter hullet til N tegn i bredden, der N er 1 til 24. JavaScript, Python, HTML og SQL virker alle.

JavaScript

JSON

{
  "templateId": "code.fillBlank",
  "data": {
    "code": "async function loadQuiz(id) {\n  const response = await fetch(`/api/quizzes/${id}`)\n  if (!response.ok) {\n    throw new Error(\"Could not load quiz\")\n  }\n  return ___{15}\n}",
    "language": "javascript"
  }
}

Python

JSON

{
  "templateId": "code.fillBlank",
  "data": {
    "code": "def average(scores):\n    if not scores:\n        return 0\n\n    total = sum(scores)\n    return total ___{1} len(scores)",
    "language": "python"
  }
}

HTML

JSON

{
  "templateId": "code.fillBlank",
  "data": {
    "code": "<figure class=\"quiz-image\">\n  <img\n    src=\"aurora.webp\"\n    ___{3}=\"Northern lights over Tromsø\"\n  />\n  <figcaption>Norway at night</figcaption>\n</figure>",
    "language": "html"
  }
}

SQL

SQL. Kode der den manglende biten er tydelig merket.

JSON

{
  "templateId": "code.fillBlank",
  "data": {
    "code": "SELECT subject, COUNT(*) AS question_count\nFROM questions\nWHERE status = 'published'\nGROUP BY ___{7}\nORDER BY question_count DESC;",
    "language": "sql"
  }
}

Hva du kan putte i en brikke

Bygg et bilde av tekst, tall og hull. Emoji, stablede emoji, flagg, former, formatert tekst og LaTeX virker. {"kind":"gap","characters":N} setter et tekst- eller brikkehull til N tegn i bredden, der N er 1 til 24. Eldre markører beholder standardbredden.

textnumber?{"kind":"gap","characters":3}emojiemojiStackflagshapelatex