GET test-result

GET Retrieves an individual test result for a specific test instance.

Test results can be stored at group level, or as individual results.

Resource URL

https://www.drillster.com/api/2/test-result/{test_id}

or

https://www.drillster.com/api/2/test-result/{test_id}/{user_id}

or

https://www.drillster.com/api/2/test-result/{test_id}/{ticket}

Parameters

Field Type Description
test_id
required
String

The ID of the test definition. This defines the test itself, not the individual instances done by users.

Example value: 7OuHq7RcQOCsnGWR58TnBw

user_id
optional
String

The user ID of the user to retrieve test details for. If omitted, the details for the own user account are returned.

Example value: j7Yvq-ynQeWNnHTNWRV9wA

ticket
optional
String

A ticket number issued by Drillster for use with anonymous tests.

Example value: jK8TJ11kcA7YvqUhd873kJ

Either a user ID or a test ticket can be used, not both!

Response

A TestResult object, with details about the test itself, the achieved score, and the individual given answers and corrections.

Example request

GET https://www.drillster.com/api/2/test-result/HmOZ3fMbRxulVH77XYR8nQ/GNiyJoCtRTyQmmy-P9xlfA

Response

{
  "completed": "2013-09-10T14:56:12Z",
  "correctlyAnswered": 0,
  "drills": [
    {
      "drill": {
        "id": "rCiRiK6gzUupEAmP2RAE1g",
        "name": "Hiragana",
        "subject": "Japanese",
        "type": "DRILL"
      },
      "score": 0
    }
  ],
  "includedColumnNames": [
    "Hiragana"
  ],
  "progress": 1.0,
  "questions": [
    {
      "answerColumn": "Rōmaji",
      "answered": true,
      "correct": false,
      "correctAnswer": "wo",
      "givenAnswer": "ya",
      "question": "ゃ",
      "questionColumn": "Hiragana"
    },
    {
      "answerColumn": "Rōmaji",
      "answered": true,
      "correct": false,
      "correctAnswer": "e",
      "givenAnswer": "ho",
      "question": "え",
      "questionColumn": "Hiragana"
    },
    {
      "answerColumn": "Hiragana",
      "answered": true,
      "correct": false,
      "correctAnswer": "そ",
      "givenAnswer": "ぜ",
      "question": "so",
      "questionColumn": "Rōmaji"
    },
    {
      "answerColumn": "Hiragana",
      "answered": true,
      "correct": false,
      "correctAnswer": "ぬ",
      "givenAnswer": "お",
      "question": "nu",
      "questionColumn": "Rōmaji"
    }
  ],
  "score": 0,
  "size": 4,
  "started": "2013-09-10T14:56:07Z",
  "style": "MULTIPLE_CHOICE",
  "subject": "Japanese"
}

Error responses

The following error situations are possible:

ID Description
missing_test_key No test key given.
not_found The requested test result was not found.