Skip to main content

Exams

Exam List​

Use this API to list all upcoming, ongoing or past exams.

 GET /exam/{userId}/trainee-exam-list

Path parameters​

FieldTypeDescription
userId
required
integerUser ID

Query string parameters​

FieldTypeDescription
type
required
integer
  1. 1 - upcoming/ongoing
  2. 2 - past exam list
  3. 3 - list all attempts of an exam
examIdintegerexamId is required when type = 3
qstringfilter data by title
{
    "success": true,
    "data": {
        "response": {
            "acknowledgement": "Success",
            "data": {
                "examList": [
                    {
                        "enrollmentId": 706283,
                        "examScheduleId": 139853,
                        "examId": 1,
                        "examTitle": "Principle Of Effective Manager",
                        "examInstruction": "<p>EXAM INSTRUCTIONS:</p><p>1) Exam duration is for 40 minutes.</p><p>2) Exam is for 25 Marks and the required Passing Marks are 15.</p><p>3) In case of disconnection due to network failure or power outage you can login and continue the exam by clicking Continue</p><p>(Note: Time lost due to network failure or power outage is not compensated.)</p><p>4) For technical issues during exam you can mail to info@alphalearn.com.</p><p>5) Read the question and click on the right answer and press next to proceed to the next question.</p><p>6) You will see the attempted questions appearing in green on the right-hand top corner.</p><p>7) In case you do not know the answer you may flag the question and come back to answer the same.</p><p>8) You may also make changes in any specific answer if you have rethought your option.</p><p>9) This Post-assessment is available till 23rd February'21.</p><p>10) If you attempt to minimize or change the tab during an ongoing exam more than 5 times, you will receive a pop-up notification with a warning on the screen and the exam will immediately end.</p>",
                        "examStartDate": "2023-08-29",
                        "examEndDate": "2023-09-02",
                        "examAttemptedDate": "0000-00-00 00:00:00",
                        "examSubmitedDate": "0000-00-00 00:00:00",
                        "examScheduleStatus": 0,
                        "userExamActivityId": null,
                        "totalQuestion": 10,
                        "isProctor": true,
                        "totalMarks": 10,
                        "examDuration": 10,
                        "isprogresshundred": "1",
                        "enrollmentEndDate": "2023-09-28",
                        "completedPercent": "41",
                        "action": {
                            "canStart": false,
                            "comment": "Webcam Proctored Exam cannot be attempted using a mobile device."
                        }
                    }
                ],
                "lastAttemptedExam": null
            },
            "error": {
                "code": "",
                "internal_message": "",
                "moreInfo": []
            }
        }
    }
}

Exam Start​

Use this API to start an exam.

 GET /exam/{examId}/start

Path parameters​

FieldTypeDescription
examId
required
integerExam ID
{
    "success": true,
    "data": {
        "response": {
            "acknowledgement": "Success",
            "data": {
                "examDetails": {
                    "interruptSetting": {
                        "browser": {
                            "enable": true,
                            "maxInterruptionCount": 5,
                            "myInterruptionCount": 0
                        },
                        "proctor": {
                            "enable": false,
                            "maxInterruptionCount": 5,
                            "showAlerIfFaceNotDetectedInSecond": 30,
                            "captureIntervalInMinutes": 10,
                            "myInterruptionCount": 0
                        }
                    },
                    "userExamActivityId": 33910,
                    "examId": 299,
                    "examTitle": "B2B Sales Management",
                    "examScheduleId": 139869,
                    "startDate": "2023-08-30",
                    "endDate": "2023-09-14",
                    "duration": 15,
                    "totalQuestion": 10,
                    "totalMarks": 30,
                    "passingMarks": 20,
                    "attempted": 0,
                    "correct": 0,
                    "timeLeftInSeconds": 900
                },
                "questions": [
                    {
                        "questionBody": "How to mearsure an Equity Risk",
                        "queMark": 5,
                        "single_multiple": 1,
                        "options": [
                            {
                                "option": "Beta"
                            },
                            {
                                "option": "Standard Deviation"
                            },
                            {
                                "option": "VAR"
                            },
                            {
                                "option": "All of the Above"
                            }
                        ],
                        "questionId": 22405,
                        "isFlag": false,
                        "userAnswer": null
                    },   
                ]
            },
            "error": {
                "code": "",
                "internal_message": "",
                "moreInfo": []
            }
        }
    }
}

Submit Exam Answers​

Use this API to submit answers, clear answers, flag questions.

 POST /exam/trainee-question-action

Request body parameters​

FieldTypeDescription
type
required
integer
  1. 1 - insert
  2. 2 - update
  3. 3 - insert flag
  4. 4 - remove flag
  5. 5 - clear question
userExamActivityId
required
integerThe user exam activiy ID
questionId
required
integerThe question ID
answerOption
required
integerThe answer
{
    "success": true,
    "data": {
        "response": {
            "acknowledgement": "Success",
            "data": true,
            "error": {
                "code": "",
                "internal_message": "",
                "moreInfo": []
            }
        }
    }
}

Interrupt Exam​

Use this API to capture browser minimize event.

 POST /exam/trainee-exam-interrupt

Request body parameters​

FieldTypeDescription
type
required
integer
  1. 1 - browser event
userExamActivityId
required
integerThe user exam activiy ID
{
    "success": true,
    "data": {
        "response": {
            "acknowledgement": "Success",
            "data": {
                "forceToSubmitExam": false,
                "eventCount": 1
            },
            "error": {
                "code": "",
                "internal_message": "",
                "moreInfo": []
            }
        }
    }
}

Submit/End Exam​

Use this API to submit/end an exam.

 GET /exam/{userExamActivityId}/complete

Path parameters​

FieldTypeDescription
userExamActivityId
required
integerThe userExamActivityId

Query string parameters​

FieldTypeDescription
submittedBy
required
integer
  1. 1 - Trainee
  2. 2 - Automatic - Time Lapsed
  3. 3 - Automatic - Browser Minimize Limit Reached
  4. 4 - Automatic - Face Not Detected Limit Reached
{
    "success": true,
    "data": {
        "response": {
            "acknowledgement": "Success",
            "data": null,
            "error": {
                "code": "",
                "internal_message": "",
                "moreInfo": []
            }
        }
    }
}

View Exam Answer sheet​

Use this API to view exam answer sheet listing the questions and attempted answers.

 GET /exam/{userExamActivityId}/view-exam-paper

Path parameters​

FieldTypeDescription
userExamActivityId
required
integerThe userExamActivityId
{
    "success": true,
    "data": {
        "response": {
            "acknowledgement": "Success",
            "data": {
                "examDetails": {
                    "examId": 4,
                    "examTitle": "Human Resource Management",
                    "totalMarks": 6,
                    "totalQuestion": 6,
                    "passingMarks": 4,
                    "attempted": 6,
                    "correct": 4,
                    "obtainedMarks": 4,
                    "examAttemptedDate": "2023-08-23 15:30:07",
                    "examDuration": 30
                },
                "questions": [
                    {
                        "questionBody": "__________ arises when two people or groups have dissenting views on moral values-that basic understanding of what is naturally right or wrong.",
                        "queMark": "1",
                        "single_multiple": "1",
                        "options": [
                            {
                                "examQuestionID": "27",
                                "eoption": "minor offences"
                            },
                            {
                                "examQuestionID": "27",
                                "eoption": "major offences"
                            },
                            {
                                "examQuestionID": "27",
                                "eoption": "all offences"
                            },
                            {
                                "examQuestionID": "27",
                                "eoption": "None of the above"
                            }
                        ],
                        "questionId": 27,
                        "isFlag": false,
                        "userAnswer": "1",
                        "correctOptionIs": "1"
                    }                
                ]
            },
            "error": {
                "code": "",
                "internal_message": "",
                "moreInfo": []
            }
        }
    }
}