binus_api's Introduction

Binus API

An unofficial REST API to fetch Binus data like class schedule and exam schedule.

If you are interested to contribute feel free to send a pull request.

General API Information

Base endpoint url is: https://binus-api.vercel.app/api
All endpoints return either a JSON object or array.
available endpoints are:
- Schedule: POST /api/schedule.
- Exam: POST /api/exam.
- Exam History: POST /api/examHistory.

Error

Any post endpoint can return an error

This is a sample of error payload:

{
  "ok": false,
  "message": "Invalid username or password!"
}

Endpoints Information

All requests must be sent with POST.
For each request you need to include these JSON body parameters to make the call valid:

Name	Type	Optional	Description
username	string	No	Binus username without `@binus.ac.id`.
password	string	No	Binus account pasword.

Schedule

Get a class schedule.

URL: /api/schedule
Method: POST

Response:

{
    "ok": true,
    "result": [...]
}

Exam

Get the latest exam schedule.

URL: /api/exam
Method: POST

Response:

{
  "ok": true,
  "result": {...}
}

Exam History

Get the history of user exam uploaded answer sheets url.

URL: /api/examHistory
Method: POST
Additional parameters

Name	Type	Optional	Description
username	string	No	Binus account username.
password	string	No	Binus account pasword.
ExamQuestionID	string	No	ExamQuestionID of the course. Every course has a unique ID. Recieved from `/api/exam`.

Response:

{
  "ok": true,
  "result": [
    {
    "Upload": 1,
    "SubmissionTime": "Friday XX July YY, 00:00:00",
    "Title": "string",
    "Url": "string"
    },
    {...}
  ]
}

Example

bellow is an example of POST request using Python (requests):

import requests

res = requests.post(
    "https://binus-api.vercel.app/api/schedule",
    json={"username": "User123", "password": "Pass123"}
)

print(res.json())