Integration Results Webhook
Process
It is worth noting that an exam undergoes a number of state changes during its life:
-
-
-
- Ready
- Started
- Finished
- Review
- Technical Difficulty
- Invalidated
- Completed
- 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:
Specific Field Detail:
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 |
If the exam contains a Grammar section the data will include:
Grammar_Level |
the iTEP level assigned to the grammar section Valid values: 0.0 - 6.0 |
Grammar_Score | the iTEP Test ID |
Valid |
|
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 |
Overall_Level | the iTEP level assigned to the test as a whole Valid values: 0.0 - 6.0 |