Grade Import Resource
OpenLoop API Grade Resource all the import of grades into the gradebook. Must be used in conjuntion with the Roster Resource.
The Grades resource allows applications to upload grade data for student assignments into School Loop gradebooks. The operations are summarized below:
Operation | HTTP Method | Description | Example URI |
---|---|---|---|
Create | POST | Add grades | https://myhs.schoolloop.com/api/grades |
IMPORTANT: The HTTP authorization headers must be set with a valid, privileged School Loop user name, and your web-service password. For example “jsmith:mywebpass”. Note also that all parameters must be properly URL encoded. All successful web-service POST calls return HTTP status SC_OK on successful completion. An error code, and detailed message is returned if a call fails to execute for any reason.
The add-grades operation is executed with a simple http POST command. The URI format to create a new HP group is https://myhs.schoolloop.com/api/grades
The POST’ed data must consist of grade-records, one-per-line, in the format:
section-id student-id assignment-id grade
For example:
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 detailed message describing the failure is returned.