Skip to main content

Integration Results Webhook

Process

It is worth noting that an exam undergoes a number of state changes during its life:

        1.  Ready 
        2.  Started
        3.  Finished
        4.  Review
        5.  Technical Difficulty
        6.  Invalidated
        7.  Completed
        8.  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:

image.png

 Data sent:

image.png

  

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

Overall CEFR level

See CEFR Levels for definition

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
Grammar_Percent the percent of correct answers for the grammar section
Valid values: 0 - 100
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