The Paperscorer-Learnosity API enables Learnosity users to include advanced printing and scanning capabilities into their platforms. It is meant to be used in combination with the Paperscorer Core API functionality. Details for the Paperscorer Core API can be found at the link below and the Paperscorer-Learnosity API can be shared on request.
- Paperscorer Core API
After account setup, we will provide you with API credentials for accessing the Core API. Regardless of the Paperscorer process, the first step is to provide authentication as an API partner (oAuthoToken) and then to login to Paperscorer on behalf of the educator who is using your system (userLogin). If this is the first time that the educator has been logged into Paperscorer, we will create a new account. After login, session information will be returned by Paperscorer, which can then be used in subsequent calls to the Paperscorer API.
Creating an Answer Sheet
The first step in the Paperscorer process is for an educator to create answer ("bubble") sheets, based on a given Activity or series of Items, for their students. When this endpoint is called, Paperscorer dynamically generates the answer sheets based on the Learnosity Item IDs or Activity IDs provided. A unique URL is returned by the endpoints to a PDF file, which can be printed and distributed to students. Students can fill these answer sheets out using pen or pencil. A "Form ID" is also returned, which is a unique ID for this answer sheet in Paperscorer's database. This Form ID should be saved to your platform and associated with the Activity or Assessment ID in your platform so that student scores can be retrieved from Paperscorer later..
Scanning Answer Sheets for Scoring
There are three ways that educators can send their scanned answer sheets to Paperscorer for scoring.
- Using the Paperscorer Mobile App - Responses are automatically sent to the Paperscorer services for scoring. No integration effort required.
- Scanning and Emailing - Responses are automatically sent to the Paperscorer services for scoring. No integration effort required.
- Scanning and Uploading - A means to upload scanned sheets must be added to your platform.
Retrieving Scores for Students
To return Learnosity sessions related to to a processed form, call the getSessionIDsfromFormID endpoint in the Paperscorer-Learnosity API. This endpoint returns a series of session IDs from Learnosity for each student answer sheet successfully processed by Paperscorer. After receiving session IDs and syncing the responses with your platform, it is important for your to call the acknowledgeSyncScore endpoint. This endpoint removes the student's results from subsequent responses. You can then use Learnosity APIs to retrieve student scores just as you would if the scores were submitted by the student online.