Grade Import API Resource – School Loop Support

Overview

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.

Operational Information

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
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 are returned if a call fails to execute for any reason.

Back to the top

Posting Grades

The add-grades operation is executed with a simple HTTP POST command. The URL 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 following 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.

Back to the top

Confirmation

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.

Back to the top