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())

License

Licensed under MIT License.

Made with ❤️