Each candidate will receive a unique URL for their attempt. The URL must contain a “Session Token” which uniquely authorises the attempt access to the candidate. The process by which this Session Token is attained is described in the Authentication page.URL structure#
https://<subdomain>.synap.ac/quiz/a/<Attempt ID>?st=<Session Token>
You shouldn’t need to parse through the URL to display the attempt, however, to service other use-cases you may wish to extract the Attempt ID
and Session Token
from the URL for later use.Attempt lifecycle#
The attempt should automatically load assuming the Attempt ID
and Session Token
are valid. There are four possible states the attempt can be in: loading
, error
, in-progress
and completed
.Look for a <meta>
tag inside the <head>
with a property called syn:attempt-player-status
. The content will contain one of the following:undefined
: if the <meta>
element is not found, the page’s javascript is not ready
loading
: the Quiz Player is loading
error
: the Quiz Player failed to load; usually due to an invalid url or network issue
in-progress
: the page is ready and the user taking their attempt
completed
: the user has submitted their attempt and is viewing the Results screen
Modified at 2024-11-06 13:57:55