Launch

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

URL structure#

Attempt lifecycle#

URL structure

Attempt lifecycle