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.