MrMissx/Binus_API

An unofficial REST API to fetch Binus data.

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 ❤️