2.0 Question object

A Question contains all information that is required to present a practice question to a user.

Example

{
  "reference": "pepKDyrLR760Dk7XqxODrw",
  "sequenceNr" : 314,
  "ask" : {
    "name": "Capital",
    "term" : {
      "value": "Tripoli"
    }
  },
  "tell" : {
    "name": "Country",
    "composition": "SINGLE",
    "type": "MULTIPLE_CHOICE",
    "terms" : [ {
      "value": "Comoros"
    }, {
      "value": "Trinidad and Tobago"
    }, {
      "value": "Libya"
    }, {
      "value": "Vietnam"
    } ]
  }
}

Fields

Field Type Description
reference
required
String Unique reference (ID) for this question. When submitting the answer for this question, this reference must be included. The ID is globally unique. Should the same question be asked again, it would have a different reference.

Example value: gUaA56tcQfyXpMJc9EE4sQ
sequenceNr
optional
Integer The sequence number of the question being asked for the drill from which this question is taken. Absent for introductions.

Example value: 1
ask
required
2.0 Ask object The question itself.
tell
required
2.0 Tell object All data related to answering the question: how the question must be answered (multiple choice or open-ended), if a single answer or multiple answers are expected, and which answers must be presented.
context
optional
2.0 Context object A message that provides contextual information for this question.
timeLimit
optional
Integer If specified, the user must submit the answer within this number of seconds. Otherwise the question will be considered incorrectly answered, regardless of the answer that was submitted.