Attendance API Resource – School Loop Support

Overview

The OpenLoop API Attendance Resource provides a web-interface for importing daily and period attendance data into School Loop and displaying that data on student and parent dashboards.

Operations

The Attendance Resource allows applications to upload both daily and per-section student attendance data:

Operation	HTTP Method	Description	Sample URI
Create	POST	Add attendance	https://myhs.schoolloop.com/api/attendance

IMPORTANT! All posts must use SSL (https). 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 Attendance

The import-attendance operation is executed with an HTTP POST command. The posted data must meet the following criteria:

Consists of attendance-records
One record per line
Tab-separated format
Includes date, permanent student ID, and daily attendance code

Any number of section attendance “[sectionID:attendance-code]” pairs:

The following template shows the correct formatting:

MM/dd/yyyy, permanentID, day attendanceCode, sectionID1:code1, sectionID2:code2, …

Example:

01/07/2014 7339962  1041:I  2042:I  3046:I  4140:I  5044:I  6042:I
01/07/2014  7340344  2041:I  3045:I  4139:I  5043:I  6043:I
01/07/2014 7341242  1028:U  2025:U  3034:U  4121:U  5024:U  5030:U
…
(tab-separated)

Back to the top

Service Response

Successful attendance-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.

Back to the top