New Pre-Checks and Allowed Resources Through API Update!
ProctorU API Update Newsletter
Hello API Update Subscribers,
For those who have seen the test-taker experience before you may soon notice a change in the user experience. ProctorU has recently completed an overhaul to the pre-check UI for test-takers to make the experience more intuitive, concise, and decrease wait times. With this change in mind, ProctorU is happy to announce that in an upcoming release it will be offering users the ability to set the allowed resources for an exam with an API call. This enhancement will provide a more streamlined experience for test-takers and create more transparency surrounding permitted exam materials. We strongly encourage all our partners to review the details below and implement the discussed changes in order to fully benefit from the improved workflow for test takers.
To utilize this update you will need to include the parameters titled ‘permitted_resources_list’ and ‘other_notes’ in the request to one of our scheduling endpoints: addBlueBirdExam, addAdHocProcess, editTermExam, and batchSchedule. You might be including this information in your calls today via the notes parameter. However, moving this information to ‘permitted_resources_list’ will allow for the exam materials to be better displayed to the test taker and proctors appropriately during launch. If you would like to test this update before it’s official launch in April 2021, the new parameters will be set to active on ProctorU’s demo environment. Please contact your Account Manager for further details.
To enable any of the defined resources, include the permitted resources as a comma-separated list for the permitted resources list parameter. If you need to allow a resource not included in the list of defined resources, you can add it as free text in the other resources parameter. Proctors will only allow the materials specifically listed in your call. Additionally, the resources set to allowed will be presented to the test-taker at the beginning of their exam during the exam pre-checks. Below you will find an example of all the possible allowed resources, a screenshot of how these resources will be presented to the test-taker, and a request to the AddBlueBird endpoint including these new parameters. To find more helpful information, screenshots, and best practices for these new parameters please view the following documentation API Permitted Resources Parameter Documentation, and to see the new pre-check process for test-takers please watch the following video Candidate Experience: Certification and Professional Testing Organizations
Available Permitted Resources:
All_websites
Approved_website
bathroom_breaks
computer_calculator
Course_website
Ebook_computer
Ebook_website
Excel
Excel_notes
Financial_calculator
formula_sheet
Four_function_calculator
graphing_calculator
handwritten_notes
note_cards
Notepad
online_calculator
paint
pdf_notes
powerpoint
powerpoint_notes
printed_notes
scientific_calculator
scratch1
scratch2
scratch_more
spss
textbook
whiteboard
word
Word_notes
Test-Taker Experience Screenshot
(See Attachments)
Request:
curl --location --request POST 'https://.../api/addBlueBirdExam' \
--header 'Authorization-Token: <ProctorU provided API key>' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'time_sent=<Current Time>' \
--data-urlencode 'student_id=12345' \
--data-urlencode 'first_name=Johnny' \
--data-urlencode 'last_name=Testtaker' \
--data-urlencode 'email=JohnnyT...@proctoru.com' \
--data-urlencode 'time_zone_id=Central Standard Time' \
--data-urlencode 'exam_id=123456ABCD' \
--data-urlencode 'description=The Exam Title' \
--data-urlencode 'active_date=2021-01-01T00:00:00:00Z' \
--data-urlencode 'end_date=2022-05-30T00:00:00:00Z' \
--data-urlencode 'exam_url=https://www.proctoru.com' \
--data-urlencode 'preset=medium' \
--data-urlencode 'password=123456' \
--data-urlencode 'notes=Information only for the proctor goes here.' \
--data-urlencode 'permitted_resources_list=financial_calculator, printed_notes'
--data-urlencode 'other_resources= Matlab'
Response:
{
"time_sent": "2021-03-11T16:24:30Z",
"response_code": 1,
"message": "",
"data": {
"url": "https://demo.proctoru.com/students/reservations?login_token=NGfjdHjsq21FLJjc%3D--8fb2f15618c63ffccdbfc02d4c47349u34203e007da0&return_to="
}
}
Happy Testing!
