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.