Links
Comment on page

Question Analysis

The logs/story-question-analysis endpoint retrieves logs of all questions for a story.

Parameters

All parameters are optional and if none are provided all stories, users and groups will be called.
Key
Type
app
String (ID or name of app)
story
String (ID or name of story)
groups
Array String (name of group)
users
Array String (name or email of user)

Example

The example below fetches questions and answers for stories listed in the stories parameter.
curl -X POST \
v1/logs/story-question-analysis \
-H 'Authorization: Basic <Your Base64 Encoded Token>' \
-d '{
"story" : "Story A"
}'

Success Response

A successful response will return an array of story + questions items.
{
"status": "success",
"data": [
{
"story": {
"ID": "EV72-RQZY-80AH",
"name": "Story A",
"type": "story",
"app": {
"ID": "io.falkor.demo",
"name": "Falkor",
"version": "2.5.0"
}
},
"questions": [
{
"question": "Question 1: What is the color of the sky in the daytime?",
"type": "Multiple Choice",
"possibleAnswers": [
"Green",
"Blue",
"Purple",
"Black"
],
"stats": {
"total": 2,
"correct": 1,
"incorrect": 1
},
"answers": [
{
"firstname": "User",
"lastname": "One",
"email": "[email protected]",
"groups": [
"Group A",
"Group B"
],
"answer": {
"attempts": 1,
"response": "Blue",
"correct": true
}
},
{
"firstname": "User",
"lastname": "Two",
"email": "[email protected]",
"groups": [],
"answer": {
"attempts": 1,
"response": "Purple",
"correct": false
}
},
...etc
]
},
...etc
]
},
...etc
],
"hash": "910f67a3a96dc84bb80c8035be4e0fce",
"response_time": 0.1512671947479248
}

Story + Questions Item

Key
Type
story
Object
story.ID
String (ID of story)
story.name
String
story.type
String
story.app
Object (App the story is published to)
questions
Array of Question Items

Question Item

Key
Type
question
String (The question that was asked)
type
String (Type of question)
possibleAnswers
Array String (What answers were possible)
stats
Object
stats.total
Int (Total users who have answered)
stats.correct
Int (Total user who answered correctly)
stats.incorrect
Int (Total users who answered incorrectly)
answers
Array of answer items

Answer Item

Key
Type
firstname
String
lastname
String
email
String
telephone
String
country
String
city
String
groups
Array String (groups assigned)
answer
Object
answer.attempts
Int (number of attempts)
answer.correct
Bool (if the answers was correct)
answer.response
String (the selected answer)