Type: | Package |
Title: | Interface for 'Semestry TermTime' Services |
Version: | 0.1.0 |
Description: | Provides an R interface for interacting with the 'Semestry TermTime' services. It allows users to retrieve scheduling data from the API. see https://github.com/vusaverse/vvtermtime/blob/main/openapi_7.7.0.pdf for details. |
URL: | https://github.com/vusaverse/vvtermtime, https://vusaverse.github.io/vvtermtime/ |
License: | MIT + file LICENSE |
Encoding: | UTF-8 |
RoxygenNote: | 7.3.2 |
Imports: | httr, jsonlite, magrittr |
Suggests: | knitr, rmarkdown |
VignetteBuilder: | knitr |
NeedsCompilation: | no |
Packaged: | 2025-07-25 13:58:14 UTC; tin900 |
Author: | Tomer Iwan [aut, cre, cph] |
Maintainer: | Tomer Iwan <t.iwan@vu.nl> |
Repository: | CRAN |
Date/Publication: | 2025-07-25 14:20:02 UTC |
Pipe operator
Description
See magrittr::%>%
for details.
Usage
lhs %>% rhs
Arguments
lhs |
A value or the magrittr placeholder. |
rhs |
A function call using the magrittr semantics. |
Value
The result of calling rhs(lhs)
.
Authenticate with Semestry Termtime API
Description
This function authenticates with the Semestry Termtime API by verifying the API key and base URL. It returns an authenticated Semestry object that can be used for subsequent API calls.
Usage
authenticate(api_key, base_url)
Arguments
api_key |
The API key for Semestry. |
base_url |
The base URL of the Semestry API. |
Value
An authenticated Semestry object.
Retrieve activity data from the Semestry API
Description
This function sends a GET request to the activities endpoint of the Semestry API and retrieves the activity data.
Usage
get_activities(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved activity data from the API.
Retrieve activity report attr from the Semestry API
Description
This function sends a GET request to the report room endpoint of the Semestry API and retrieves the room booking data.
Usage
get_activities_report_attr(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved activity report data from the API.
Retrieve activity report schedule from the Semestry API
Description
This function sends a GET request to the report room endpoint of the Semestry API and retrieves the room booking data.
Usage
get_activities_report_sche(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved activity report data from the API.
Retrieve activity group data from the Semestry API
Description
This function sends a GET request to the activity groups endpoint of the Semestry API and retrieves the activity group data.
Usage
get_activity_groups(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved activity group data from the API.
Retrieve activity template data from the Semestry API
Description
This function sends a GET request to the activity templates endpoint of the Semestry API and retrieves the activity template data.
Usage
get_activity_templates(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved activity template data from the API.
Retrieve activity type data from the Semestry API
Description
This function sends a GET request to the activity types endpoint of the Semestry API and retrieves the activity type data.
Usage
get_activity_types(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved activity type data from the API.
Retrieve assessment type data from the Semestry API
Description
This function sends a GET request to the assessment types endpoint of the Semestry API and retrieves the assessment type data.
Usage
get_assessment_types(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved assessment type data from the API.
Retrieve booking type data from the Semestry API
Description
This function sends a GET request to the booking types endpoint of the Semestry API and retrieves the booking type data.
Usage
get_booking_types(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved booking type data from the API.
Retrieve building data from the Semestry API
Description
This function sends a GET request to the buildings endpoint of the Semestry API and retrieves the building data.
Usage
get_buildings(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved building data from the API.
Retrieve campus data from the Semestry API
Description
This function sends a GET request to the campuses endpoint of the Semestry API and retrieves the campus data.
Usage
get_campuses(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved campus data from the API.
Retrieve capability data from the Semestry API
Description
This function sends a GET request to the capabilities endpoint of the Semestry API and retrieves the capability data.
Usage
get_capabilities(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved capability data from the API.
Retrieve contact requirement data from the Semestry API
Description
This function sends a GET request to the contact requirements endpoint of the Semestry API and retrieves the contact requirement data.
Usage
get_contact_requirements(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved contact requirement data from the API.
Retrieve course data from the Semestry API
Description
This function sends a GET request to the courses endpoint of the Semestry API and retrieves the course data.
Usage
get_courses(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved course data from the API.
Examples
## Not run:
semestry <- authenticate_semestry()
get_courses(semestry)
## End(Not run)
Retrieve data from the Semestry API database endpoint
Description
This function sends a GET request to the database endpoint of the Semestry API and retrieves the data.
Usage
get_database(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved data from the API database.
Retrieve department data from the Semestry API
Description
This function sends a GET request to the departments endpoint of the Semestry API and retrieves the department data.
Usage
get_departments(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved department data from the API.
Retrieve floor data from the Semestry API
Description
This function sends a GET request to the floors endpoint of the Semestry API and retrieves the floor data.
Usage
get_floors(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved floor data from the API.
Retrieve module data from the Semestry API
Description
This function sends a GET request to the modules endpoint of the Semestry API and retrieves the module data.
Usage
get_modules(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved module data from the API.
Retrieve offers from the Semestry API
Description
This function sends a GET request to the offers endpoint of the Semestry API and retrieves the offers.
Usage
get_offers(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved offers from the API.
Examples
## Not run:
semestry <- authenticate_semestry()
get_offers(semestry)
## End(Not run)
Ping the Semestry API
Description
This function sends a GET request to the ping endpoint of the Semestry API to check connectivity.
Usage
get_ping(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The ping response from the API.
Retrieve booking report from the Semestry API
Description
This function sends a GET request to the report booking endpoint of the Semestry API and retrieves the booking booking data.
Usage
get_report_booking(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved report booking data from the API.
Retrieve room report from the Semestry API
Description
This function sends a GET request to the report room endpoint of the Semestry API and retrieves the room booking data.
Usage
get_report_room(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved report room data from the API.
Retrieve room relationship data from the Semestry API
Description
This function sends a GET request to the room relationships endpoint of the Semestry API and retrieves the room relationship data.
Usage
get_room_relationships(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved room relationship data from the API.
Retrieve room booking data from the Semestry API
Description
This function sends a GET request to the roombookings endpoint of the Semestry API and retrieves the room booking data.
Usage
get_roombookings(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved room booking data from the API.
Retrieve room data from the Semestry API
Description
This function sends a GET request to the rooms endpoint of the Semestry API and retrieves the room data.
Usage
get_rooms(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved room data from the API.
Examples
## Not run:
semestry <- authenticate_semestry()
get_rooms(semestry)
## End(Not run)
Retrieve schedule rooms data from the Semestry API
Description
This function sends a GET request to the schedule/rooms endpoint of the Semestry API and retrieves the schedule rooms data.
Usage
get_schedule_rooms(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved schedule rooms data from the API.
Retrieve staff data from the Semestry API
Description
This function sends a GET request to the staff endpoint of the Semestry API and retrieves the staff data.
Usage
get_staff(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved staff data from the API.
Examples
## Not run:
semestry <- authenticate_semestry()
get_staff(semestry)
## End(Not run)
Retrieve staff group data from the Semestry API
Description
This function sends a GET request to the staff groups endpoint of the Semestry API and retrieves the staff group data.
Usage
get_staff_groups(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved staff group data from the API.
Retrieve staff pools from the Semestry API
Description
This function sends a GET request to the staffpools endpoint of the Semestry API and retrieves the staff pools.
Usage
get_staff_pools(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved staff pools from the API.
Retrieve student group mapppings from the Semestry API
Description
This function sends a GET request to the studentgroupmaps endpoint of the Semestry API and retrieves the student group mappings data.
Usage
get_student_group_maps(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved student group maps from the API.
Retrieve student group data from the Semestry API
Description
This function sends a GET request to the student groups endpoint of the Semestry API and retrieves the student group data.
Usage
get_student_groups(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved student group data from the API.
Retrieve student data from the Semestry API
Description
This function sends a GET request to the students endpoint of the Semestry API and retrieves the student data.
Usage
get_students(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved student data from the API.
Examples
## Not run:
semestry <- authenticate_semestry()
get_students(semestry)
## End(Not run)
Retrieve supergroup data from the Semestry API
Description
This function sends a GET request to the supergroups endpoint of the Semestry API and retrieves the supergroup data.
Usage
get_supergroups(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved supergroup data from the API.
Retrieve timeframes data from the Semestry API
Description
This function sends a GET request to the timeframes endpoint of the Semestry API and retrieves the timeframes data.
Usage
get_timeframes(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved timeframes data from the API.
Retrieve timetable data for a specific module from the Semestry API
Description
This function sends a GET request to the timetable module endpoint of the Semestry API and retrieves the timetable data for a specific module.
Usage
get_timetable_module(semestry, module_code, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
module_code |
The module code to retrieve timetable data for. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved timetable data for the specified module from the API.
Retrieve timetable data for a specific room from the Semestry API
Description
This function sends a GET request to the timetable room endpoint of the Semestry API and retrieves the timetable data for a specific room.
Usage
get_timetable_room(semestry, room_code, start = NULL, end = NULL, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
room_code |
The room code to retrieve timetable data for. |
start |
Optional start date in YYYY-MM-DD format (10 characters). |
end |
Optional end date in YYYY-MM-DD format (10 characters). |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved timetable data for the specified room from the API.
Retrieve timetable data for a specific staff member from the Semestry API
Description
This function sends a GET request to the timetable staff endpoint of the Semestry API and retrieves the timetable data for a specific staff member.
Usage
get_timetable_staff(
semestry,
staff_code,
start = NULL,
end = NULL,
timeout = 30
)
Arguments
semestry |
An authenticated Semestry object. |
staff_code |
The staff code to retrieve timetable data for. |
start |
Optional start date in YYYY-MM-DD format (10 characters). |
end |
Optional end date in YYYY-MM-DD format (10 characters). |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved timetable data for the specified staff member from the API.
Retrieve timetable data for a specific student from the Semestry API
Description
This function sends a GET request to the timetable student endpoint of the Semestry API and retrieves the timetable data for a specific student.
Usage
get_timetable_student(
semestry,
student_code,
start = NULL,
end = NULL,
timeout = 30
)
Arguments
semestry |
An authenticated Semestry object. |
student_code |
The student code to retrieve timetable data for. |
start |
Optional start date in YYYY-MM-DD format (10 characters). |
end |
Optional end date in YYYY-MM-DD format (10 characters). |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved timetable data for the specified student from the API.
Retrieve webhook data from the Semestry API
Description
This function sends a GET request to the webhooks endpoint of the Semestry API and retrieves the webhook data.
Usage
get_webhooks(semestry, timeout = 30)
Arguments
semestry |
An authenticated Semestry object. |
timeout |
The timeout duration for the GET request (default: 30 seconds). |
Value
The retrieved webhook data from the API.