MercedTime's REST API

TODO: Coding Shit

• PUT /user For updating a user
• GET /subject Get a subject code, description, and id
• GET /refresh For getting a refresh token
• Add a sign in with email option (probably just changing the request body for /login).
• GET /lecture/:crn/enrollment For getting the historic enrollment stats
• GET /standalone
• Add a "last notified" field to the user table. If we want to do notifications in the future we will probably need to do date comparisons with recently updated courses
• To control which year and term for which the data is returned, write a "State" struct that contains this global route state to be accessed globally be the api. (maybe make a new internal package routes with "routes.State")

TODO: Thinking Shit

• Need to build a prerequisites tree.
• The instructor id system is a horrible hack, use a SERIAL type instead
• To make this useful for different terms, we cannot rely on crn as our only primary key, need to start making my own course ids

POST /login

Get access to protected resources by giving the login endpoint your credentials.

Example Request Body:

{
    "username": "my username",
    "password": "*R(Py*(P*F$JIjF:EJ"
}

Responses with a JSON Web Token (JWT)

GET /lectures

• limit=<limit> int Limit the number of results to <limit>
• offset=<offset> int Offset the response list by some offset number
• subject=<code> string Only return the lectures for the subject that matches <code>

{}

GET /labs

• limit=<limit> int Limit the number of results to <limit>
• offset=<offset> int Offset the response list by some offset number

{}

GET /exams

• limit=<limit> int Limit the number of results to <limit>
• offset=<offset> int Offset the response list by some offset number

{}

GET /discussions

• limit=<limit> int Limit the number of results to <limit>
• offset=<offset> int Offset the response list by some offset number

{}

GET /instructors

• limit=<limit> int Limit the number of results to <limit>
• offset=<offset> int Offset the response list by some offset number

{}

Errors

Most of the endpoints will respond with the same error type that looks something like this.

{
    "error": "you did a bad thing",
    "status": 400
}

Configuration

# mt.yml
host: 0.0.0.0
port: 8080
secret: 'some long string'
in_memory_rate_store: true

tls: true
cert: ./mercedtime.com+4.pem
key: ./mercedtime.com+4-key.pem

db:
  driver: 'postgres'
  password: 'database password here'
  name: 'database name'
  port: 5432
  user: 'database user'
  ssl: 'disable'