Wellemo — online tests and quizzes

Create an online knowledge test (exam-style quiz with scoring) on Wellemo from questions you write, and get a link to share. Participants take it in the browser without registration; the author sees every result, score and the hardest questions. Returns: take_url (public, send it to participants), edit_url (PRIVATE: lets the author edit the test and see results; opening it while logged in to Wellemo saves the test to the account) and results_url. Always show the user take_url and edit_url and tell them to keep edit_url private. Write questions in the language of the user. Up to 100 questions.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Test title."
    },
    "description": {
      "type": "string",
      "description": "Short description shown before the start."
    },
    "language": {
      "type": "string",
      "enum": [
        "ru",
        "en",
        "de",
        "fr",
        "es"
      ],
      "description": "Interface language of the test page. Default: detected from the title."
    },
    "time_limit": {
      "type": "integer",
      "description": "Time limit for the whole test in minutes, 0 or omitted = no limit."
    },
    "pass_score": {
      "type": "number",
      "description": "Pass threshold in percent (0-100), optional."
    },
    "show_answers": {
      "type": "string",
      "enum": [
        "end",
        "each",
        "none"
      ],
      "description": "When participants see correct answers: end (after finishing, default), each (after every question), none."
    },
    "questions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "single",
              "multiple",
              "truefalse",
              "text",
              "number",
              "matching",
              "ordering",
              "gap"
            ],
            "description": "single: one correct option; multiple: several correct options; truefalse; text: typed answer; number: numeric answer; matching: pairs; ordering: items in the right order; gap: answers in [square brackets] inside the text, e.g. \"The capital of France is [Paris]\"."
          },
          "text": {
            "type": "string",
            "description": "Question text."
          },
          "options": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "single/multiple: answer options."
          },
          "correct": {
            "description": "single: 0-based index of the correct option; multiple: array of 0-based indexes; truefalse: true or false."
          },
          "answers": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "text: accepted answers (case-insensitive)."
          },
          "answer": {
            "type": "number",
            "description": "number: the correct value."
          },
          "tolerance": {
            "type": "number",
            "description": "number: allowed deviation, default 0."
          },
          "pairs": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "minItems": 2,
              "maxItems": 2
            },
            "description": "matching: [[\"left\", \"right\"], ...]."
          },
          "items": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "ordering: items in the correct order (they are shuffled for participants)."
          },
          "points": {
            "type": "number",
            "description": "Points for the question, default 1."
          },
          "explanation": {
            "type": "string",
            "description": "Optional explanation shown after answering."
          }
        },
        "required": [
          "text"
        ]
      },
      "minItems": 1,
      "maxItems": 100
    }
  },
  "required": [
    "title",
    "questions"
  ]
}

Get a summary of results for a Wellemo knowledge test: number of participants, average score, pass rate, average time and the questions people got wrong most often. Needs the private edit_url (or its id) returned by create_knowledge_test. Participant names are not returned; full results are at results_url.

{
  "type": "object",
  "properties": {
    "edit_url": {
      "type": "string",
      "description": "The private edit_url of the test (or the id from it)."
    }
  },
  "required": [
    "edit_url"
  ]
}

Search the public Wellemo catalog of ready-made tests and quizzes by topic. Returns titles, short descriptions, number of takes and a link to take each test on Wellemo. Questions are not returned: give the user the links.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Topic or keywords, in the language of the tests you look for."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Max results, default 5."
    }
  },
  "required": [
    "query"
  ]
}