Skip to content

SS APIs Version 4.9 Stable Release

Latest
Latest
Compare
Choose a tag to compare
@prawich-th prawich-th released this 01 Apr 13:50
· 64 commits to main since this release
ss-apis4.9
47f9b6b
This commit was created on github.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.

SS APIs 💾

Contents

Introduction 🖊️

Welcome to the SS APIs' Repository, SS APIs is an APIs used across all our products.

This API is used for most of our latest products, like Timetables, Central Authentication and more.

Features 📝

Auth

  • Login
  • Signup
  • Change password
  • Change profile picture
  • Change profile (Name, color, etc.)
  • Get user's configurations

System 13

  • All the player data for System13
  • Add players
  • Delete players

Timetables v3

Basically this is the new timetables is the re-written version of Timetables.

  • Timetables Key Feature
    • Create Timetable
    • Get Timetable
      • Includes
        • Timetable Format (format)
        • Timetable Content (timetableData)
        • Current Class Indicator (indicator)
    • Get Glance (getGlance)
      • Includes
        • Current Class Code (curClass)
        • Next Class Code (nextClass)
        • Timetable Format (format)
    • Get Format
      • If not selected will return every format in the system.
      • Client Can select what school / program client want.
    • Get My Class
      • Return user's primary class and a list of classes user have starred.
  • Adding Or Remove Class From User
    • Get Class From School
      • return a class that user still dont have from the school selected.
    • Register Class
    • Remove Class

Notes

The timetalbe format send with every endpoints but getFormat are selected for that school and program, client just need to select the language.

Canceled / Legacy apis 📦

Expenses (CANCELED)

Timetables v2 (Legacy)

  • Create timetables
  • Add timetable
  • Get timetables
  • Get user
  • Get glance
  • Create class
  • Get current class indicator

Versions 📜

Current Version | 4.9

Previous Versions

  • Version 1.0
    • All basic API features.
  • Version 1.1
    • Added errors handling (central error handling middleware).
  • Version 1.2
    • Returned errors messages with the response for the client.
    • Remove behind the scene bugs.
  • Version 2.0
    • Added validation for adding players.
  • Version 3.0
    • SS Account support and polished system13's API endpoints + expenses project.
  • Version 4.0
    • SS Timetables v2.0 features.
  • Version 4.6 > 4.7
    • Modal from backend system
    • Re-written the API for better optimization.
  • Version 4.8 > Present
    • Timetable v3.0 (or in SS APIs new Timetable)

Download ⬇️

After cloning the git repository

1.) Install all dependencies

> npm install

// or

> yarn install

2.) Locally run the program

> npm start

// OR

> nodemon

Notes:

You can change the server's port in ./src/app.ts

  app.listen(8000)
             ^^^^ Change This

you can change it to any port you like.

License ⚖️

This project is protected under

Mozilla Public License v2.0

To read the full license Click here

MPL 2.0 © 2021-2022 Prawich Thawansakdivudhi & Jirat Chutrakul (SS Developers)

Assets 2
Loading