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": "[e-mail]",
                            "groups": [
                                "Group A",
                                "Group B"
                            ],
                            "answer": {
                                "attempts": 1,
                                "response": "Blue",
                                "correct": true
                            }
                        },
                        {
                            "firstname": "User",
                            "lastname": "Two",
                            "email": "[e-mail]",
                            "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)