KOU Letter Grade Calculator, KOUBS Istatistik Wrapper & Web API

In prod. https://kou-letter-grade-calculator.herokuapp.com/

Docker (Development)

docker-compose up

Web API

Authorization

Currently, all requests don't require authentication.

Responses

{
  "success" : bool,
  "data"    : string | array
}

The success attribute describes if the transaction was successful or not. The data attribute contains any other metadata associated with the response. This will be an escaped string containing JSON data if successful or an empty array if fails.

Status Codes

API returns the following status codes:

Status Code	Description
200	OK
400	BAD REQUEST
404	NOT FOUND
500	INTERNAL SERVER ERROR

API Routes

Get Academic Terms [GET]

Get academic terms that exists in KOUBS Istatistik database.

/api/academic-terms

Get Faculties [GET]

Get faculties.

/api/faculties

Get Schools [GET]

Get schools.

/api/schools

Get Vocational Schools [GET]

Get vocational schools.

/api/vocational-schools

Get All Departments [GET]

Get all departments.

/api/departments

Get Specific Departments [GET]

Get specific departments.

/api/departments/{unitKey}/{facultyKey}

Example: Get Faculty of Engineering Departments

/api/departments/1/02 

Get Courses Of Department [GET]

Get courses of deparment.

/api/courses/{departmentKey}[/{academicTermKey}]

Get Course Data And Calculate Letter Grade [POST]

/api/course