Integration Results Webhook
Process
It is worth noting that an exam undergoes a number of state changes during its life:
-
-
-
- Ready
- Incomplete
- Finished
- Review
- Problem
- Invalidated
- Complete
- Disabled
-
-
Currently webhook calls are executed at the following processing points:
-
-
-
- When The status of the exam changes to Finished (Optional)
- When the status of the exam changes to Completed
- If any type of reset is executed for the exam
- If the exam is invalidated
- If the exam encountered a technical issue
-
-
When any of the above described events occur, a check is made the determines if the test has a tracking code assigned to it. Tracking codes are created and maintained by iTEP staff. These codes are used to identify the endpoint, authorization methods and parameters, and if a call is to be executed when the test is finished.
The call is a post call. The data in the all is a single form-encoded field named data, and the data is a JSON string that contains the results.
See Webhook Output Sample for an example.
Headers sent:
Data sent:
IMPORTANT! |
|
Note that there is ONE form encoded field named data.
The field data contains a JSON encoded string that, in turn, contains all of the fields sent by the result webhook. |
|
Results detail such as scores and the score report URL are returned ONLY when a test has passed all technical and integrity reviews and is given a completed status by the iTEP academics department. |
Specific Field Detail:
General Fields Always included:
| OID | the remote system unique ID for this test |
| TestID | the iTEP Test ID |
| Duration | Number of minutes candidate spent taking the exam |
| TestDate | M/D/YYYY the date the test was finished M will be a number between 1 and 12 D will be a number between 1 and 31 YYYY will be a number greater than 1900 |
| TestMonth | the month the test was finished Valid values: a number between 1 and 12 |
| TestDay | the day of the month the test was finished Valid values: a number between 1 and 31 |
| TestYear | the year the test was finished Valid values: a number greater than 1900 |
| score_report_url | URL that will generate a formatted score report with skill breakdowns and explanations |
| Overall_Level | the iTEP level assigned to the test as a whole Valid values: 0.0 - 6.0 |
| Overall_cefr |
Overall CEFR level See CEFR Levels for definition |
| Status |
Exam status, as described in the previous section |
Grammar Section Fields:
| Grammar_Level |
the iTEP level assigned to the grammar section Valid values: 0.0 - 6.0 |
| Grammar_Score | the iTEP Test ID |
| Grammar_Percent | the percent of correct answers for the grammar section Valid values: 0 - 100 |
| Grammar_cefr |
Grammar CEFR level See CEFR Levels for definition |
Listening Section Fields:
| Listening_Level |
the iTEP level assigned to the Listening section Valid values: 0.0 - 6.0 |
| Listening_Score | the iTEP Test ID |
| Listening_Percent | the percent of correct answers for the Listening section Valid values: 0 - 100 |
| Listening_cefr |
Listening CEFR level See CEFR Levels for definition |
Reading Section Fields:
| Reading_Level |
the iTEP level assigned to the Reading section Valid values: 0.0 - 6.0 |
| Reading_Score | the iTEP Test ID |
| Reading_Percent | the percent of correct answers for the Reading section Valid values: 0 - 100 |
| Reading_cefr |
Reading CEFR level See CEFR Levels for definition |
Writing Section Fields:
| Writing_Level |
the iTEP level assigned to the Writing section Valid values: 0.0 - 6.0 |
| Writing_Score | the iTEP Test ID |
| Writing_Percent | the percent of correct answers for the Writing section Valid values: 0 - 100 |
| Writing_cefr |
Writing CEFR level See CEFR Levels for definition |
| Writing_Question_Count |
Number of questions in the writing section NOTE: This is a numeric field |
| Writing_Question_1 |
As of 10/16/2024 this field will always contain a empty string |
| Writing_Answer_1 |
As of 10/16/2024 this field will always contain a empty string |
| Writing_Question_2 |
As of 10/16/2024 this field will always contain a empty string |
| Writing_Answer_2 |
As of 10/16/2024 this field will always contain a empty string |
Speaking Section Fields:
| Speaking_Level |
the iTEP level assigned to the Speaking section Valid values: 0.0 - 6.0 |
| Speaking_Score | the iTEP Test ID |
| Speaking_Percent | the percent of correct answers for the Speaking section Valid values: 0 - 100 |
| Speaking_cefr |
Speaking CEFR level See CEFR Levels for definition |