CTU Sirius API API documentation version v1
https://sirius.fit.cvut.cz/api/v1
/events
Get a collection of events without any scope.
get /events
Get a collection of events without any scope.
Sirius uses OAuth 2.0 authorization server of FIT CTU. See https://rozvoj.fit.cvut.cz/Main/oauth2 for more information.
Query Parameters
- limit: (number - default: 10 - maximum: 100)
The number of entries in collection to return
- offset: (number - default: 0)
Offset of the first entry in collection
- include: (string)
A comma-separated list of the link names to include.
Example:
courses,teachers,schedule_exceptions
- event_type: (one of assessment, course_event, exam, laboratory, lecture, tutorial)
Filter by event's type
- deleted: (boolean - default: false)
Return even events that have been deleted.
- from: (date)
Return events from this date
- to: (date)
Return events up to this date
- with_original_date: (boolean - default: false)
When the date of event has been changed by a schedule exception, original date is not considered for date filtering (by from/to parameters). With this parameter Sirius will include events’ original date in a date filter.
HTTP status code 200
Body
Type: application/json
Example:
{
"meta": {
"count": 2,
"offset": 0,
"limit": 20
},
"events": [
{
"id": 42,
"name": null,
"sequence_number": 12,
"starts_at": "2014-04-23T09:15:00.000+02:00",
"ends_at": "2014-04-23T10:45:00.000+02:00",
"deleted" : false,
"capacity": 24,
"occupied": 20,
"event_type": "tutorial",
"parallel": "106",
"original_data": {
"starts_at": "2014-04-23T09:00:00.000+02:00",
"ends_at": "2014-04-23T10:30:00.000+02:00",
"room_id": "T9:111"
},
"links": {
"room": "T9:350",
"course": "MI-RUB",
"teachers": [
"skocdopet"
],
"students": [
"szolatib",
"vomackar"
],
"applied_exceptions": [ 10, 15 ]
}
},
{
"id": 43,
"name": null,
"sequence_number": 12,
"starts_at": "2014-04-24T09:15:00.000+02:00",
"ends_at": "2014-04-24T10:45:00.000+02:00",
"deleted" : false,
"capacity": 196,
"occupied": 190,
"event_type": "lecture",
"parallel": "1",
"original_data": {},
"links": {
"room": "T9:155",
"course": "MI-W20",
"teachers": [
"kuchajar",
"vitvatom"
],
"students": [
"jirutjak"
]
}
}
]
}
Type: text/calendar
Example:
BEGIN:VCALENDAR
VERSION:2.0
CALSCALE:GREGORIAN
BEGIN:VEVENT
DTSTAMP:20140702T140133Z
UID:https://sirius.fit.cvut.cz/events/123
DTSTART:20140312T101500
DTEND:20140312T114500
CLASS:PUBLIC
CREATED:20140410T182546
LAST-MODIFIED:20140410T182546
LOCATION:T9:130
SUMMARY:MI-PSL 2. cvičení
END:VEVENT
BEGIN:VEVENT
DTSTAMP:20140702T140133Z
UID:https://sirius.fit.cvut.cz/events/125
DTSTART:20140312T101500
DTEND:20140312T114500
CLASS:PUBLIC
CREATED:20140410T182546
LAST-MODIFIED:20140410T182546
LOCATION:T9:130
SUMMARY:MI-PSL 2. cvičení
END:VEVENT
END:VCALENDAR
HTTP status code 404
There are no events within the current scope
Secured by oauth2
Headers
- Authorization: ()
Used to send a valid OAuth 2 access token. Do not use with the
access_token
query string parameter.Example:
Bearer 07a855e0-6920-11e4-a40a-0002a5d5c51b
HTTP status code 401
Bad or expired token. This can happen if the user or OAAS revoked or expired an access token. To fix, you should request a new token.
HTTP status code 403
Bad OAuth request (wrong client secret, scopes, expired token...).
Get event with the specified ID.
get /events/{eventId}
Get event with the specified ID.
Sirius uses OAuth 2.0 authorization server of FIT CTU. See https://rozvoj.fit.cvut.cz/Main/oauth2 for more information.
URI Parameters
- eventId: required (string)
HTTP status code 200
Body
Type: application/json
Example:
{
"events": {
"id": 42,
"name": null,
"sequence_number": 12,
"starts_at": "2014-04-23T07:30:00.000+02:00",
"ends_at": "2014-04-23T11:00:00.000+02:00",
"deleted" : false,
"capacity": 24,
"occupied": 18,
"event_type": "tutorial",
"parallel": "106",
"original_data": {
"starts_at": "2014-04-23T09:00:00.000+02:00",
"ends_at": "2014-04-23T10:30:00.000+02:00",
"room_id": "T9:111"
},
"links": {
"room": "T9:350",
"course": "MI-RUB",
"teachers": [
"skocdopet"
],
"students": [
"szolatib",
"vomackar"
],
"applied_exceptions": [ 10, 15 ]
}
}
}
Type: text/calendar
Example:
BEGIN:VCALENDAR
VERSION:2.0
CALSCALE:GREGORIAN
BEGIN:VEVENT
DTSTAMP:20140702T140133Z
UID:https://sirius.fit.cvut.cz/events/123
DTSTART:20140312T101500
DTEND:20140312T114500
CLASS:PUBLIC
CREATED:20140410T182546
LAST-MODIFIED:20140410T182546
LOCATION:T9:130
SUMMARY:MI-PSL 2. cvičení
END:VEVENT
END:VCALENDAR
Secured by oauth2
Headers
- Authorization: ()
Used to send a valid OAuth 2 access token. Do not use with the
access_token
query string parameter.Example:
Bearer 07a855e0-6920-11e4-a40a-0002a5d5c51b
HTTP status code 401
Bad or expired token. This can happen if the user or OAAS revoked or expired an access token. To fix, you should request a new token.
HTTP status code 403
Bad OAuth request (wrong client secret, scopes, expired token...).
/people/{username}
Get person's full name and local access token. This token allows access to her personal calendar only and it's intended for iCalendar.
get /people/{username}
Get person's full name and local access token. This token allows access to her personal calendar only and it's intended for iCalendar.
Sirius uses OAuth 2.0 authorization server of FIT CTU. See https://rozvoj.fit.cvut.cz/Main/oauth2 for more information.
URI Parameters
- username: required (string - pattern: [a-z0-9]{3,8})
person's unique username
Example:
flynnkev
HTTP status code 200
Body
Type: application/json
Example:
{
"people": {
"id": "elisruby",
"full_name": "Ing. Elisia Ruby",
"access_token": "72816e82-f5b2-4909-b7c7-770ad017e645"
}
}
Secured by oauth2
Headers
- Authorization: ()
Used to send a valid OAuth 2 access token. Do not use with the
access_token
query string parameter.Example:
Bearer 07a855e0-6920-11e4-a40a-0002a5d5c51b
HTTP status code 401
Bad or expired token. This can happen if the user or OAAS revoked or expired an access token. To fix, you should request a new token.
HTTP status code 403
Bad OAuth request (wrong client secret, scopes, expired token...).
Get a calendar for the person.
get /people/{username}/events
Get a calendar for the person.
Sirius uses OAuth 2.0 authorization server of FIT CTU. See https://rozvoj.fit.cvut.cz/Main/oauth2 for more information.
URI Parameters
- username: required (string - pattern: [a-z0-9]{3,8})
person's unique username
Example:
flynnkev
Query Parameters
- limit: (number - default: 10 - maximum: 100)
The number of entries in collection to return
- offset: (number - default: 0)
Offset of the first entry in collection
- include: (string)
A comma-separated list of the link names to include.
Example:
courses,teachers,schedule_exceptions
- event_type: (one of assessment, course_event, exam, laboratory, lecture, tutorial)
Filter by event's type
- deleted: (boolean - default: false)
Return even events that have been deleted.
- from: (date)
Return events from this date
- to: (date)
Return events up to this date
- with_original_date: (boolean - default: false)
When the date of event has been changed by a schedule exception, original date is not considered for date filtering (by from/to parameters). With this parameter Sirius will include events’ original date in a date filter.
HTTP status code 200
Body
Type: application/json
Example:
{
"meta": {
"count": 2,
"offset": 0,
"limit": 20
},
"events": [
{
"id": 42,
"name": null,
"sequence_number": 12,
"starts_at": "2014-04-23T09:15:00.000+02:00",
"ends_at": "2014-04-23T10:45:00.000+02:00",
"deleted" : false,
"capacity": 24,
"occupied": 20,
"event_type": "tutorial",
"parallel": "106",
"original_data": {
"starts_at": "2014-04-23T09:00:00.000+02:00",
"ends_at": "2014-04-23T10:30:00.000+02:00",
"room_id": "T9:111"
},
"links": {
"room": "T9:350",
"course": "MI-RUB",
"teachers": [
"skocdopet"
],
"students": [
"szolatib",
"vomackar"
],
"applied_exceptions": [ 10, 15 ]
}
},
{
"id": 43,
"name": null,
"sequence_number": 12,
"starts_at": "2014-04-24T09:15:00.000+02:00",
"ends_at": "2014-04-24T10:45:00.000+02:00",
"deleted" : false,
"capacity": 196,
"occupied": 190,
"event_type": "lecture",
"parallel": "1",
"original_data": {},
"links": {
"room": "T9:155",
"course": "MI-W20",
"teachers": [
"kuchajar",
"vitvatom"
],
"students": [
"jirutjak"
]
}
}
]
}
Type: text/calendar
Example:
BEGIN:VCALENDAR
VERSION:2.0
CALSCALE:GREGORIAN
BEGIN:VEVENT
DTSTAMP:20140702T140133Z
UID:https://sirius.fit.cvut.cz/events/123
DTSTART:20140312T101500
DTEND:20140312T114500
CLASS:PUBLIC
CREATED:20140410T182546
LAST-MODIFIED:20140410T182546
LOCATION:T9:130
SUMMARY:MI-PSL 2. cvičení
END:VEVENT
BEGIN:VEVENT
DTSTAMP:20140702T140133Z
UID:https://sirius.fit.cvut.cz/events/125
DTSTART:20140312T101500
DTEND:20140312T114500
CLASS:PUBLIC
CREATED:20140410T182546
LAST-MODIFIED:20140410T182546
LOCATION:T9:130
SUMMARY:MI-PSL 2. cvičení
END:VEVENT
END:VCALENDAR
HTTP status code 404
There are no events within the current scope
Secured by oauth2
Headers
- Authorization: ()
Used to send a valid OAuth 2 access token. Do not use with the
access_token
query string parameter.Example:
Bearer 07a855e0-6920-11e4-a40a-0002a5d5c51b
HTTP status code 401
Bad or expired token. This can happen if the user or OAAS revoked or expired an access token. To fix, you should request a new token.
HTTP status code 403
Bad OAuth request (wrong client secret, scopes, expired token...).
/teachers/{username}/events
Get a teacher's calendar for the specified person. This is a subset of the person's calendar with only events which the person teaches (classes), examines (exams) or organizes (one-off events).
get /teachers/{username}/events
Get a teacher's calendar for the specified person. This is a subset of the person's calendar with only events which the person teaches (classes), examines (exams) or organizes (one-off events).
Sirius uses OAuth 2.0 authorization server of FIT CTU. See https://rozvoj.fit.cvut.cz/Main/oauth2 for more information.
URI Parameters
- username: required (string - pattern: [a-z0-9]{3,8})
Person's unique username.
Example:
flynnkev
Query Parameters
- limit: (number - default: 10 - maximum: 100)
The number of entries in collection to return
- offset: (number - default: 0)
Offset of the first entry in collection
- include: (string)
A comma-separated list of the link names to include.
Example:
courses,teachers,schedule_exceptions
- event_type: (one of assessment, course_event, exam, laboratory, lecture, tutorial)
Filter by event's type
- deleted: (boolean - default: false)
Return even events that have been deleted.
- from: (date)
Return events from this date
- to: (date)
Return events up to this date
- with_original_date: (boolean - default: false)
When the date of event has been changed by a schedule exception, original date is not considered for date filtering (by from/to parameters). With this parameter Sirius will include events’ original date in a date filter.
HTTP status code 200
Body
Type: application/json
Example:
{
"meta": {
"count": 2,
"offset": 0,
"limit": 20
},
"events": [
{
"id": 42,
"name": null,
"sequence_number": 12,
"starts_at": "2014-04-23T09:15:00.000+02:00",
"ends_at": "2014-04-23T10:45:00.000+02:00",
"deleted" : false,
"capacity": 24,
"occupied": 20,
"event_type": "tutorial",
"parallel": "106",
"original_data": {
"starts_at": "2014-04-23T09:00:00.000+02:00",
"ends_at": "2014-04-23T10:30:00.000+02:00",
"room_id": "T9:111"
},
"links": {
"room": "T9:350",
"course": "MI-RUB",
"teachers": [
"skocdopet"
],
"students": [
"szolatib",
"vomackar"
],
"applied_exceptions": [ 10, 15 ]
}
},
{
"id": 43,
"name": null,
"sequence_number": 12,
"starts_at": "2014-04-24T09:15:00.000+02:00",
"ends_at": "2014-04-24T10:45:00.000+02:00",
"deleted" : false,
"capacity": 196,
"occupied": 190,
"event_type": "lecture",
"parallel": "1",
"original_data": {},
"links": {
"room": "T9:155",
"course": "MI-W20",
"teachers": [
"kuchajar",
"vitvatom"
],
"students": [
"jirutjak"
]
}
}
]
}
Type: text/calendar
Example:
BEGIN:VCALENDAR
VERSION:2.0
CALSCALE:GREGORIAN
BEGIN:VEVENT
DTSTAMP:20140702T140133Z
UID:https://sirius.fit.cvut.cz/events/123
DTSTART:20140312T101500
DTEND:20140312T114500
CLASS:PUBLIC
CREATED:20140410T182546
LAST-MODIFIED:20140410T182546
LOCATION:T9:130
SUMMARY:MI-PSL 2. cvičení
END:VEVENT
BEGIN:VEVENT
DTSTAMP:20140702T140133Z
UID:https://sirius.fit.cvut.cz/events/125
DTSTART:20140312T101500
DTEND:20140312T114500
CLASS:PUBLIC
CREATED:20140410T182546
LAST-MODIFIED:20140410T182546
LOCATION:T9:130
SUMMARY:MI-PSL 2. cvičení
END:VEVENT
END:VCALENDAR
HTTP status code 404
There are no events within the current scope
Secured by oauth2
Headers
- Authorization: ()
Used to send a valid OAuth 2 access token. Do not use with the
access_token
query string parameter.Example:
Bearer 07a855e0-6920-11e4-a40a-0002a5d5c51b
HTTP status code 401
Bad or expired token. This can happen if the user or OAAS revoked or expired an access token. To fix, you should request a new token.
HTTP status code 403
Bad OAuth request (wrong client secret, scopes, expired token...).
/rooms/{kosId}/events
Get a calendar for the room.
get /rooms/{kosId}/events
Get a calendar for the room.
Sirius uses OAuth 2.0 authorization server of FIT CTU. See https://rozvoj.fit.cvut.cz/Main/oauth2 for more information.
URI Parameters
- kosId: required (string - pattern: [A-Z0-9]{2}:([A-Z0-9]+-)?[a-z0-9]+)
Common room identification used by KOS, for details see the documentation.
Example:
TH:A-1333
Query Parameters
- limit: (number - default: 10 - maximum: 100)
The number of entries in collection to return
- offset: (number - default: 0)
Offset of the first entry in collection
- include: (string)
A comma-separated list of the link names to include.
Example:
courses,teachers,schedule_exceptions
- event_type: (one of assessment, course_event, exam, laboratory, lecture, tutorial)
Filter by event's type
- deleted: (boolean - default: false)
Return even events that have been deleted.
- from: (date)
Return events from this date
- to: (date)
Return events up to this date
- with_original_date: (boolean - default: false)
When the date of event has been changed by a schedule exception, original date is not considered for date filtering (by from/to parameters). With this parameter Sirius will include events’ original date in a date filter.
HTTP status code 200
Body
Type: application/json
Example:
{
"meta": {
"count": 2,
"offset": 0,
"limit": 20
},
"events": [
{
"id": 42,
"name": null,
"sequence_number": 12,
"starts_at": "2014-04-23T09:15:00.000+02:00",
"ends_at": "2014-04-23T10:45:00.000+02:00",
"deleted" : false,
"capacity": 24,
"occupied": 20,
"event_type": "tutorial",
"parallel": "106",
"original_data": {
"starts_at": "2014-04-23T09:00:00.000+02:00",
"ends_at": "2014-04-23T10:30:00.000+02:00",
"room_id": "T9:111"
},
"links": {
"room": "T9:350",
"course": "MI-RUB",
"teachers": [
"skocdopet"
],
"students": [
"szolatib",
"vomackar"
],
"applied_exceptions": [ 10, 15 ]
}
},
{
"id": 43,
"name": null,
"sequence_number": 12,
"starts_at": "2014-04-24T09:15:00.000+02:00",
"ends_at": "2014-04-24T10:45:00.000+02:00",
"deleted" : false,
"capacity": 196,
"occupied": 190,
"event_type": "lecture",
"parallel": "1",
"original_data": {},
"links": {
"room": "T9:155",
"course": "MI-W20",
"teachers": [
"kuchajar",
"vitvatom"
],
"students": [
"jirutjak"
]
}
}
]
}
Type: text/calendar
Example:
BEGIN:VCALENDAR
VERSION:2.0
CALSCALE:GREGORIAN
BEGIN:VEVENT
DTSTAMP:20140702T140133Z
UID:https://sirius.fit.cvut.cz/events/123
DTSTART:20140312T101500
DTEND:20140312T114500
CLASS:PUBLIC
CREATED:20140410T182546
LAST-MODIFIED:20140410T182546
LOCATION:T9:130
SUMMARY:MI-PSL 2. cvičení
END:VEVENT
BEGIN:VEVENT
DTSTAMP:20140702T140133Z
UID:https://sirius.fit.cvut.cz/events/125
DTSTART:20140312T101500
DTEND:20140312T114500
CLASS:PUBLIC
CREATED:20140410T182546
LAST-MODIFIED:20140410T182546
LOCATION:T9:130
SUMMARY:MI-PSL 2. cvičení
END:VEVENT
END:VCALENDAR
HTTP status code 404
There are no events within the current scope
Secured by oauth2
Headers
- Authorization: ()
Used to send a valid OAuth 2 access token. Do not use with the
access_token
query string parameter.Example:
Bearer 07a855e0-6920-11e4-a40a-0002a5d5c51b
HTTP status code 401
Bad or expired token. This can happen if the user or OAAS revoked or expired an access token. To fix, you should request a new token.
HTTP status code 403
Bad OAuth request (wrong client secret, scopes, expired token...).
/courses/{courseCode}/events
Get a calendar for the course.
get /courses/{courseCode}/events
Get a calendar for the course.
Sirius uses OAuth 2.0 authorization server of FIT CTU. See https://rozvoj.fit.cvut.cz/Main/oauth2 for more information.
URI Parameters
- courseCode: required (string)
Course code, faculty specific.
Example:
BI-PA1
Query Parameters
- limit: (number - default: 10 - maximum: 100)
The number of entries in collection to return
- offset: (number - default: 0)
Offset of the first entry in collection
- include: (string)
A comma-separated list of the link names to include.
Example:
courses,teachers,schedule_exceptions
- event_type: (one of assessment, course_event, exam, laboratory, lecture, tutorial)
Filter by event's type
- deleted: (boolean - default: false)
Return even events that have been deleted.
- from: (date)
Return events from this date
- to: (date)
Return events up to this date
- with_original_date: (boolean - default: false)
When the date of event has been changed by a schedule exception, original date is not considered for date filtering (by from/to parameters). With this parameter Sirius will include events’ original date in a date filter.
HTTP status code 200
Body
Type: application/json
Example:
{
"meta": {
"count": 2,
"offset": 0,
"limit": 20
},
"events": [
{
"id": 42,
"name": null,
"sequence_number": 12,
"starts_at": "2014-04-23T09:15:00.000+02:00",
"ends_at": "2014-04-23T10:45:00.000+02:00",
"deleted" : false,
"capacity": 24,
"occupied": 20,
"event_type": "tutorial",
"parallel": "106",
"original_data": {
"starts_at": "2014-04-23T09:00:00.000+02:00",
"ends_at": "2014-04-23T10:30:00.000+02:00",
"room_id": "T9:111"
},
"links": {
"room": "T9:350",
"course": "MI-RUB",
"teachers": [
"skocdopet"
],
"students": [
"szolatib",
"vomackar"
],
"applied_exceptions": [ 10, 15 ]
}
},
{
"id": 43,
"name": null,
"sequence_number": 12,
"starts_at": "2014-04-24T09:15:00.000+02:00",
"ends_at": "2014-04-24T10:45:00.000+02:00",
"deleted" : false,
"capacity": 196,
"occupied": 190,
"event_type": "lecture",
"parallel": "1",
"original_data": {},
"links": {
"room": "T9:155",
"course": "MI-W20",
"teachers": [
"kuchajar",
"vitvatom"
],
"students": [
"jirutjak"
]
}
}
]
}
Type: text/calendar
Example:
BEGIN:VCALENDAR
VERSION:2.0
CALSCALE:GREGORIAN
BEGIN:VEVENT
DTSTAMP:20140702T140133Z
UID:https://sirius.fit.cvut.cz/events/123
DTSTART:20140312T101500
DTEND:20140312T114500
CLASS:PUBLIC
CREATED:20140410T182546
LAST-MODIFIED:20140410T182546
LOCATION:T9:130
SUMMARY:MI-PSL 2. cvičení
END:VEVENT
BEGIN:VEVENT
DTSTAMP:20140702T140133Z
UID:https://sirius.fit.cvut.cz/events/125
DTSTART:20140312T101500
DTEND:20140312T114500
CLASS:PUBLIC
CREATED:20140410T182546
LAST-MODIFIED:20140410T182546
LOCATION:T9:130
SUMMARY:MI-PSL 2. cvičení
END:VEVENT
END:VCALENDAR
HTTP status code 404
There are no events within the current scope
Secured by oauth2
Headers
- Authorization: ()
Used to send a valid OAuth 2 access token. Do not use with the
access_token
query string parameter.Example:
Bearer 07a855e0-6920-11e4-a40a-0002a5d5c51b
HTTP status code 401
Bad or expired token. This can happen if the user or OAAS revoked or expired an access token. To fix, you should request a new token.
HTTP status code 403
Bad OAuth request (wrong client secret, scopes, expired token...).
/faculties/{facultyId}
Get a collection of semester-related parameters for the specified days.
get /faculties/{facultyId}/schedule/days
Get a collection of semester-related parameters for the specified days.
URI Parameters
- facultyId: required (string)
Faculty code (5 digits).
Example:
18000
Query Parameters
- from: (date)
Return events from this date
- to: (date)
Return events up to this date
Get semester-related parameters for the specified day.
get /faculties/{facultyId}/schedule/days/{date}
Get semester-related parameters for the specified day.
URI Parameters
- facultyId: required (string)
Faculty code (5 digits).
Example:
18000
- date: required (string)
The date to resolve, or string
current
for the current day.Example:
Wed Jan 06 2016 01:00:00 GMT+0100 (CET)
HTTP status code 200
Body
Type: application/json
Example:
{
"semester_days": {
"date": "2016-01-06",
"cwday": 3,
"period_type": "teaching",
"teaching_week": 13,
"week_parity": "even",
"links": {
"semester": "18000-B151",
"period": 8
}
}
}
Get a collection of semester-related attributes of the specified weeks.
get /faculties/{facultyId}/schedule/weeks
Get a collection of semester-related attributes of the specified weeks.
URI Parameters
- facultyId: required (string)
Faculty code (5 digits).
Example:
18000
Query Parameters
- from: (date)
Return events from this date
- to: (date)
Return events up to this date
Get semester-related attributes of the specified week.
get /faculties/{facultyId}/schedule/weeks/{year_cweek}
Get semester-related attributes of the specified week.
URI Parameters
- facultyId: required (string)
Faculty code (5 digits).
Example:
18000
- year_cweek: required (string)
An ISO 8601 week-based year and week number of the week to resolve, or string
current
for the current week.Example:
2015-52
HTTP status code 200
Body
Type: application/json
Example:
{
"semester_weeks": {
"starts_at": "2015-12-21",
"ends_at": "2015-12-27",
"cweek": 52,
"period_types": [ "teaching", "holiday" ],
"teaching_week": 12,
"week_parity": "even",
"links": {
"semester": "18000-B151",
"periods": [ 5, 6, 7 ]
}
}
}
Get a collection of semesters for the faculty.
get /faculties/{facultyId}/semesters
Get a collection of semesters for the faculty.
URI Parameters
- facultyId: required (string)
Faculty code (5 digits).
Example:
18000
Query Parameters
- limit: (number - default: 10 - maximum: 100)
The number of entries in collection to return
- offset: (number - default: 0)
Offset of the first entry in collection
HTTP status code 200
Body
Type: application/json
Example:
{
"semesters": [
{
"id": "18000-B142",
"semester": "B142",
"faculty": 18000,
"starts_at": "2015-02-16",
"ends_at": "2015-09-21",
"exams_start_at": "2015-05-18",
"exams_end_at": "2015-06-27",
"teaching_ends_at": "2015-05-16",
"first_week_parity": "even",
"hour_duration": 45,
"hour_starts": [
"07:30", "08:15", "09:15", "10:00", "11:00", "11:45",
"12:45", "13:30", "14:30", "15:15", "16:15", "17:00",
"18:00", "18:45", "19:45"
]
}
],
"meta": {
"count": 4,
"offset": 0,
"limit": 1
}
}
Get a semester with the specified KOS code for the faculty.
get /faculties/{facultyId}/semesters/{code}
Get a semester with the specified KOS code for the faculty.
URI Parameters
- facultyId: required (string)
Faculty code (5 digits).
Example:
18000
- code: required (string - pattern: [AB][0-9]{2}[12])
A semester code.
Example:
18000-B142
HTTP status code 200
Body
Type: application/json
Example:
{
"semesters": {
"id": "18000-B151",
"semester": "B151",
"faculty": 18000,
"starts_at": "2015-10-05",
"ends_at": "2016-02-22",
"exams_start_at": "2016-01-11",
"exams_end_at": "2016-02-21",
"teaching_ends_at": "2016-01-10",
"first_week_parity": "odd",
"hour_duration": 45,
"hour_starts": [
"07:30", "08:15", "09:15", "10:00", "11:00", "11:45",
"12:45", "13:30", "14:30", "15:15", "16:15", "17:00",
"18:00", "18:45", "19:45"
],
"periods": [
{
"type": "teaching",
"irregular": false,
"starts_at": "2015-10-05",
"ends_at": "2015-12-20",
"first_week_parity": "odd"
},
{
"type": "teaching",
"irregular": true,
"starts_at": "2015-12-21",
"ends_at": "2015-12-21",
"first_week_parity": "even",
"first_day_override": "wednesday"
},
{
"type": "teaching",
"irregular": true,
"starts_at": "2015-12-22",
"ends_at": "2015-12-22",
"first_week_parity": "odd",
"first_day_override": "tuesday"
},
{
"type": "holiday",
"irregular": false,
"starts_at": "2015-12-23",
"ends_at": "2016-01-03"
},
{
"type": "teaching",
"irregular": false,
"starts_at": "2016-01-04",
"ends_at": "2016-01-10",
"first_week_parity": "even"
},
{
"type": "exams",
"irregular": false,
"starts_at": "2016-01-11",
"ends_at": "2016-02-20"
}
]
}
}
/schedule_exceptions
Manage schedule exceptions
Get a collection of schedule exceptions.
get /schedule_exceptions
Get a collection of schedule exceptions.
Query Parameters
- limit: (number - default: 10 - maximum: 100)
The number of entries in collection to return
- offset: (number - default: 0)
Offset of the first entry in collection
HTTP status code 200
Body
Type: application/json
Example:
{
"schedule_exceptions": [
{
"id": 1,
"type": "CANCEL",
"name": "Den české státnosti",
"scope": {
"starts_at": "2014-09-28T00:00:00.000+02:00",
"ends_at": "2014-09-29T00:00:00.000+02:00",
"faculty": null,
"semester": null,
"courses": null,
"timetable_slots": null
}
},
{
"id": 11,
"type": "CANCEL"
"name": "Děkanský den FIT",
"note": "Výuka odpadá",
"scope": {
"starts_at": "2015-04-30T00:00:00Z",
"ends_at": "2015-05-01T00:00:00Z",
"faculty": 18000,
"semester": "B142",
"courses": null,
"timetable_slots": null
}
}
],
"meta": {
"count": 2,
"offset": 0,
"limit": 20
}
}
Get a schedule exception with the specified ID.
get /schedule_exceptions/{id}
Get a schedule exception with the specified ID.
URI Parameters
- id: required (string)
ID of the schedule exception
HTTP status code 200
Body
Type: application/json
Example:
{
"schedule_exceptions": {
"id": 7,
"type": "ROOM_CHANGE",
"name": "MI-MPI - přednáška 24. 9. 2014 přesunuta do T9:105",
"scope": {
"starts_at": "2014-09-24T00:00:00.000+02:00",
"ends_at": "2014-09-25T00:00:00.000+02:00",
"faculty": 18000,
"semester": "B141",
"courses": null,
"timetable_slots": [ 392651000 ]
},
"options": {
"room_id": "T9:105"
}
}
}
/semesters
This resource is DEPRECATED, use /faculties/{facultyId}/semesters
instead.
get /semesters
This resource is DEPRECATED, use /faculties/{facultyId}/semesters
instead.
Sirius uses OAuth 2.0 authorization server of FIT CTU. See https://rozvoj.fit.cvut.cz/Main/oauth2 for more information.
Query Parameters
- limit: (number - default: 10 - maximum: 100)
The number of entries in collection to return
- offset: (number - default: 0)
Offset of the first entry in collection
- faculty: (integer)
Filter semesters by faculty id
Secured by oauth2
Headers
- Authorization: ()
Used to send a valid OAuth 2 access token. Do not use with the
access_token
query string parameter.Example:
Bearer 07a855e0-6920-11e4-a40a-0002a5d5c51b
HTTP status code 401
Bad or expired token. This can happen if the user or OAAS revoked or expired an access token. To fix, you should request a new token.
HTTP status code 403
Bad OAuth request (wrong client secret, scopes, expired token...).
This resource is DEPRECATED, use /faculties/{facultyId}/semesters/{code}
instead.
get /semesters/{faculty_semester}
This resource is DEPRECATED, use /faculties/{facultyId}/semesters/{code}
instead.
Sirius uses OAuth 2.0 authorization server of FIT CTU. See https://rozvoj.fit.cvut.cz/Main/oauth2 for more information.
URI Parameters
- faculty_semester: required (string - pattern: [0-9]{5}-[AB][0-9]{2}[12])
Faculty code and semester code connected with a dash.
Example:
18000-B142
Secured by oauth2
Headers
- Authorization: ()
Used to send a valid OAuth 2 access token. Do not use with the
access_token
query string parameter.Example:
Bearer 07a855e0-6920-11e4-a40a-0002a5d5c51b
HTTP status code 401
Bad or expired token. This can happen if the user or OAAS revoked or expired an access token. To fix, you should request a new token.
HTTP status code 403
Bad OAuth request (wrong client secret, scopes, expired token...).
/search
Seach courses, people and rooms with the queried string in ID or title. This resource is designed especially for an instant search (aka result autosuggestion).
get /search
Seach courses, people and rooms with the queried string in ID or title. This resource is designed especially for an instant search (aka result autosuggestion).
Sirius uses OAuth 2.0 authorization server of FIT CTU. See https://rozvoj.fit.cvut.cz/Main/oauth2 for more information.
Query Parameters
- limit: (number - default: 10 - maximum: 100)
The number of entries in collection to return
- offset: (number - default: 0)
Offset of the first entry in collection
- q: required (string)
Search query
HTTP status code 200
Body
Type: application/json
Example:
{
"results": [
{
"id": "MI-RUB",
"title": "Programování v Ruby",
"type": "course"
},
{
"id": "rubyelis",
"title": "Ing. Elisia Ruby",
"type": "person"
}
],
"meta": {
"offset": 0,
"limit": 2
}
}
Secured by oauth2
Headers
- Authorization: ()
Used to send a valid OAuth 2 access token. Do not use with the
access_token
query string parameter.Example:
Bearer 07a855e0-6920-11e4-a40a-0002a5d5c51b
HTTP status code 401
Bad or expired token. This can happen if the user or OAAS revoked or expired an access token. To fix, you should request a new token.
HTTP status code 403
Bad OAuth request (wrong client secret, scopes, expired token...).