Spec

If it were me I would use the fol­low­ing URL con­ven­tion to admin­is­ter the tests system:

Verbs:

• action={ cre­ate | test | report | query }

Verb Para­me­ters & Returns:

• cre­ate
  • SubjectID={string for user}
  • Gender={m | f}
  • Hand={r | l}
  • BY={19xx — 20xx}
  • BM=(1–12}
  • BD=(1–31}
  • Return: Suc­cess or fail
• test
  • Sub­jec­tID={ Subject }
  • PackageID={Test pack­age definition}
  • Return: Link to test
•  report 
  • Sub­jec­tID
  • type={graph | single} 
    • if type=single
    • TestID={test ID}
  • Return: URL to Report
• query
  • Sub­jec­tID
  • Return: Sub­ject Details, array of test IDs

Exam­ple URL Strings:

• Cre­ate a Sub­ject: https://sync.cnsvs.com/api?action=create&SubjectID=ralph&Gender=m&Hand=r&BY=1972&BM=3&BD=28
• Cre­ate a Test: https://sync.cnsvs.com/api?action=test&SubjectID=ralph
• Retrieve a Graph Report: https://sync.cnsvs.com/api?action=report&SubjectID=ralph&type=graph
• Retrieve a Test: https://sync.cnsvs.com/api?action=report&SubjectID=ralph&type=single&TestID={xyzzab}
• Retrieve info for a Sub­ject: https://sync.cnsvs.com/api?action=query&SubjectID=ralph

Client Jobs:

1. Retain Sub­ject ID rel­a­tive to id strings
2. Set­up the tests
3. Man­age tak­ing of tests.

Test Fram­ing:

• Ide­al­ly we would admin­is­ter the test with­in an iframe to min­i­mize dis­ori­en­ta­tion of the client while tak­ing the test.  Same page
• Ide­al­ly flow from test sign up to tak­ing the test with­out ever pass­ing an email.