The purpose of this article is to help users with the task of importing grades into the gradebook using the OpenLoop API Grade Resource, which must be used in conjunction with the Roster Resource.
The Grade Resource allows applications to upload grade data for student assignments into School Loop gradebooks. The operations are summarized below:
|Operation||HTTP Method||Description||Example URL|
The add-grades operation is executed with a simple HTTP
POST command. The URL format to create a new HP group is
The POST’ed data must consist of grade-records, one-per-line, in the following format:
section-id student-id assignment-id grade
118745742305 118745854898 118890973032 A+
118745745305 118745854498 189890973032 A+
118745725305 118745859382 118990973032 C
118745425305 118745845897 118890973032 B-
All ID’s are School Loop system ID’s. Note that a valid user-name and password must be set in the HTTP Authorization header.
Successful grade-post operations return the HTTP status code SC_OK (200) and a one-line text response: SUCCESS.
If an operation fails, an error status code and a detailed message describing the failure is returned to help users troubleshoot the error.