Workflow for API Integration
The most common workflow when using Testinvite's API
The most common scenario for using the Testinvite's API is as below:
- You application makes a call
(CREATE TICKETS)
to Testinvite's API for the creation of one or multiple Tickets for a Task that you choose. - Testinvite creates the Tickets inside your Task and returns back the tracking IDs as well as the Access links for the test-takers.
- You application shares the Access links with the test-takers.
- Each test-taker follows the given Access link and a new Assessment is created.
- The test-taker takes the Tests inside the Task. Everytime a test-taker starts a Test, a new Test session is created. When a Test session ends, Testinvite sends your application the result of the Test session.
(POSTING BACK TEST SESSION RESULTS)
-
Some further details
You application can create multiple Tickets at once
When you application makes an API call to request creating tickets, you can submit multiple test-takers. The maximum is 200 test-takers per call.
Email invitations can automatically be sent by Testinvite
When you application makes an API call to request creating tickets, you can also ask for sending email invitations to each test-taker. In this scenario, Testinvite will send invitation emails so your application does not need to share the Access links with the test-takers.
Testinvite calls your application back for posting the results of Test sessions only if your application provides a Callback URL while creating Tickets
When your application makes a request for creating tickets, a Callback URL and custom parameters can be provided. Only if the Call Back URL is provided, Testinvite will send your application back the results of Test sessions whenever one completes.
You application can query the results of Test sessions as well
While creating tickets, your application will be provided the tracking IDs for each test-taker. Later on, your application can use these tracking IDs to query the Test sessions that have been completed.