Accessing attendance lists
:: services/attendance module

These API methods allow you to create and fill attendance lists.

Methods

attendance BETA Get information of attendance.
attendance_list BETA Get information of a single attendance list.
attendance_lists BETA Get information of multiple attendance lists.
change_list_mode BETA Change mode of attendance list. This requires no set attendance for that list.
create_attendance_list BETA Create a new attendance list.
create_from_tt BETA Create new attendance lists from group meetings.
delete_list BETA Delete attendance list. This requires no set attendance for that list.
group BETA Get information of attendance lists for selected group.
update_attendance BETA Update attendance entry.

services/attendance/attendance

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://www.usosapi.amuz.bydgoszcz.pl/services/attendance/attendance

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Get information of attendance.

list_id required ID of attendance list
student_ids optional Pipe-separated list of student IDs
fields optional

Default value: student|attendance_mode

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section.

format optional

Default value: json

Format in which to return values. See supported output formats.

callback optional

Required only if you've chosen jsonp as a return format.

Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

A list of entries for specified attendance list. Each entry will be a dictionary of selected fields and their values.

If student_ids was set, then the list will be filtered to specified students.

Available fields:

  • student - student who the entry concerns.

    This field references objects returned by services/users/user method. See its returns section for possible subfields.

  • attendance_mode - mode of attendance in the meeting.

    Possible values:

    • intramural - the person was in faculty building

    • remote - the person paticipated in meeting remotely

    • justified_absence - the person was not present at the meeting, but justified their absence

    • absence - the person was not present at the meeting

    • null - the attendance was not set for this person

  • comment - comment or null if no comment was provided.

Thrown errors:

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • attendance_list_not_found - attendance list does not exist.

services/attendance/attendance_list

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://www.usosapi.amuz.bydgoszcz.pl/services/attendance/attendance_list

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Get information of a single attendance list.

list_id required ID of attendance list
fields optional

Default value: id

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section.

format optional

Default value: json

Format in which to return values. See supported output formats.

callback optional

Required only if you've chosen jsonp as a return format.

Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

A dictionary of selected fields and their values.

Available fields:

  • id - ID of the attendance list;

  • course_unit - Course unit.

    This field references objects returned by services/courses/course_unit method. See its returns section for possible subfields (only primary are allowed).

  • group_number - Group number;

  • owner - Owner of the attendance list.

    This field references objects returned by services/users/user method. See its returns section for possible subfields.

  • date - Datetime of meeting, in datetime format;

  • mode - mode of meetings of the class group.

    Possible values:

    • intramural - the meetings are conducted in faculty building

    • remote - the meetings are conducted remotely

    • hybrid - mix of the first two options, some students can be in faculty building, while others can attend remotely

Thrown errors:

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • attendance_list_not_found - attendance list does not exist.

services/attendance/attendance_lists

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://www.usosapi.amuz.bydgoszcz.pl/services/attendance/attendance_lists

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Get information of multiple attendance lists.

list_ids required Pipe-separated list of attendance list IDs.
fields optional

Default value: id

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section of attendance_list method.

format optional

Default value: json

Format in which to return values. See supported output formats.

callback optional

Required only if you've chosen jsonp as a return format.

Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

A dictionary: your list_ids will be mapped to dictionary's keys, and each value will contain the description of one attendance list, as defined in the attendance_list method.

For invalid list_ids (attendance lists which do not exist) null will be returned (instead of the attendance list object).

services/attendance/change_list_mode

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://www.usosapi.amuz.bydgoszcz.pl/services/attendance/change_list_mode

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Change mode of attendance list. This requires no set attendance for that list.

list_id required ID of attendance list
mode required Mode of meeting, as described in attendance_list

Possible values: hybrid, remote, intramural.

format optional

Default value: json

Format in which to return values. See supported output formats.

callback optional

Required only if you've chosen jsonp as a return format.

Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

Empty dict on success.

Thrown errors:

  • object_invalid - object is in invalid state.

    Possible reasons:

    • has_entries - the attendance list has entries.

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • attendance_list_not_found - attendance list does not exist.

services/attendance/create_attendance_list

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://www.usosapi.amuz.bydgoszcz.pl/services/attendance/create_attendance_list

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Create a new attendance list.

course_unit_id required ID of course unit
group_number required Group number
date required Date and time of the meeting
mode required Mode of meeting, as described in attendance_list

Possible values: hybrid, remote, intramural.

format optional

Default value: json

Format in which to return values. See supported output formats.

callback optional

Required only if you've chosen jsonp as a return format.

Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

A dictionary of the following structure:

  • list_id - ID of created attendance list.

Thrown errors:

  • object_invalid - object is in invalid state.

    Possible reasons:

    • already_exists - the attendance list already exists;

    • no_students - the group does not have any participants.

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • group_not_found - specified course group does not exist or user is not its lecturer.

services/attendance/create_from_tt

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://www.usosapi.amuz.bydgoszcz.pl/services/attendance/create_from_tt

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Create new attendance lists from group meetings.

course_unit_id required ID of course unit
group_number required Group number
default_mode required Mode of meetings in the classgroup, as described in attendance_list

Possible values: hybrid, remote, intramural.

format optional

Default value: json

Format in which to return values. See supported output formats.

callback optional

Required only if you've chosen jsonp as a return format.

Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

An empty dictionary if the entries were successfully created.

Thrown errors:

  • object_invalid - object is in invalid state.

    Possible reasons:

    • no_students - the group does not have any participants.

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • group_not_found - specified course group does not exist or user is not its lecturer;

    • meeting_not_found - specified course group has no meetings.

services/attendance/delete_list

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://www.usosapi.amuz.bydgoszcz.pl/services/attendance/delete_list

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Delete attendance list. This requires no set attendance for that list.

list_id required ID of attendance list
format optional

Default value: json

Format in which to return values. See supported output formats.

callback optional

Required only if you've chosen jsonp as a return format.

Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

Empty dict on success.

Thrown errors:

  • object_invalid - object is in invalid state.

    Possible reasons:

    • has_entries - the attendance list has entries.

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • attendance_list_not_found - attendance list does not exist.

services/attendance/group

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://www.usosapi.amuz.bydgoszcz.pl/services/attendance/group

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Get information of attendance lists for selected group.

course_unit_id required ID of course unit
group_number required Group number
fields optional

Default value: id

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section of attendance_list method.

format optional

Default value: json

Format in which to return values. See supported output formats.

callback optional

Required only if you've chosen jsonp as a return format.

Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

A list of attendance list objects, as defined in the attendance_list method.

services/attendance/update_attendance

Consumer: required Token: required Scopes: staff_perspective SSL: required
https://www.usosapi.amuz.bydgoszcz.pl/services/attendance/update_attendance

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Update attendance entry.

list_id required ID of attendance list
student_id required ID of student
attendance_mode required Mode of attendance in the meeting.

Possible values: absence, justified_absence, remote, intramural.

comment optional Comment
format optional

Default value: json

Format in which to return values. See supported output formats.

callback optional

Required only if you've chosen jsonp as a return format.

Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

Empty dictionary on success.

Thrown errors:

  • object_invalid - object is in invalid state.

    Possible reasons:

    • intramural_attendance_not_allowed - intramural attendance is not allowed in this attendance list;

    • remote_attendance_not_allowed - remote attendance is not allowed in this attendance list;

    • student_not_in_group - student is not in group for specified attendance list.

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • attendance_list_not_found - attendance list does not exist.

USOS API ver. 6.6.1.0-4a, fec89407 (2021-04-26)