SUT COURSE API (Go version) 📚

This project scrapes course data from Suranaree Uni of Tech's Reg. Typescript ver.

Getting started 🚀

Clone this repository

git clone https://github.com/pandakn/go-sut-course-api.git

cd go-sut-course-api

Start Project

go run main.go

API Reference

Get Courses

  POST /api/v1/courses

Key	Type	Description	Example
`acadYear`	`string`	Academic year (e.g. 2565)	`"2565"`
`semester`	`int`	Semester (e.g. 3)	`3`
`courseCode`	`string`	Course code pattern (e.g. "ist30 1105")	`"ist30 1105"`
`courseName`	`string`	Course name pattern (e.g. "english*")	`"english*"`
`maxRow`	`int`	Max rows in response (default is 50)	`25`
`isFilter (optional)`	`bool`	Filter by day and times (`true`) or no filter (`false`)	`true` or `false`
`day (optional)`	`string`	Weekdays for filtering courses (e.g. "monday") (e.g. "monday"). Use the format "sunday", "monday", ..., "saturday". Required if `isFilter` is `true`.	`"monday"`
`timeFrom (optional)`	`string`	Starting time for filtering courses (e.g. "08:00")	`"08:00"`
`timeTo (optional)`	`string`	Ending time for filtering courses (e.g. "12:00")	`"12:00"`

Note : Time range : 08:00 - 22:00

Note : Either one of courseCode or courseName can be entered.

Warning : If courseCode and courseName are not specified, scraping all the data will take a very long time.

Examples

Retrieve Course Data with No Filtering

use the following example:

// body request
{
  "acadYear": "2566",
  "semester": 2,
  "courseCode": "523332",
  "courseName": "",
  "maxRow": 50
}

Retrieve Course Data with Filtering

// body request
{
  "acadYear": "2566",
  "semester": 2,
  "courseCode": "523332",
  "courseName": "",
  "maxRow": 50,
  "isFilter": true,
  "day": "monday",
  "timeFrom": "10:00",
  "timeTo": "12:00"
}

Usage/Examples JSON

{
  "year": "2/2566",
  "courses": [
    {
      "courseCode": "523332",
      "version": "2",
      "courseName": {
        "en": "SOFTWARE ENGINEERING",
        "th": "วิศวกรรมซอฟต์แวร์"
      },
      "credit": "4 (3-3-9)",
      "degree": "ปริญญาตรี",
      "department": "วิศวกรรมคอมพิวเตอร์",
      "faculty": "สำนักวิชาวิศวกรรมศาสตร์",
      "courseStatus": "ใช้งาน",
      "courseCondition": ["523331"],
      "continueCourse": ["523435"],
      "equivalentCourse": null,
      "sectionsCount": 2,
      "sections": [
        {
          "id": "0baeef8b-98f8-4fdf-a16a-ef8a0c922d66",
          "url": "http://reg.sut.ac.th/registrar/class_info_2.asp?backto=home&option=0&courseid=1009172&coursecode=523332&acadyear=2566&semester=2&avs882850039=3",
          "section": "1",
          "status": "เปิดลงปกติ สามารถลงทะเบียนผ่าน WEB ได้",
          "note": "สำหรับหลักสูตรปรับปรุง พ.ศ. 2560",
          "professors": [
            "อาจารย์ ดร.คมศัลล์ ศรีวิสุทธิ์",
            "นายธนพล คงเจริญสุข",
            "นายสิทธิชัย สิริฤทธิกุลชัย",
            "นายตะวัน คำอาจ"
          ],
          "language": "TH",
          "seat": {
            "totalSeat": "45",
            "registered": "45",
            "remain": "0"
          },
          "classSchedule": [
            {
              "day": "Tu",
              "times": "09:00-12:00",
              "room": "B1139"
            },
            {
              "day": "Th",
              "times": "09:00-12:00",
              "room": "F11-422.Software"
            }
          ],
          "exams": {
            "midterm": {
              "date": "25",
              "month": "Dec",
              "times": "12:00-14:00",
              "year": "2566",
              "room": "อาคารBห้องB1115(สอบตามตารางมหาวิทยาลัย)25ธ.ค.2566"
            },
            "final": {
              "date": "14",
              "month": "Feb",
              "times": "13:00-16:00",
              "year": "2567",
              "room": "อาคารBห้องN(สอบตามตารางมหาวิทยาลัย)14ก.พ.2567"
            }
          }
        },
        {
          "id": "f8eedbc6-7c1b-4e3e-9015-348c4657802d",
          "url": "http://reg.sut.ac.th/registrar/class_info_2.asp?backto=home&option=0&courseid=1009172&coursecode=523332&acadyear=2566&semester=2&avs882850039=4",
          "section": "2",
          "status": "เปิดลงปกติ สามารถลงทะเบียนผ่าน WEB ได้",
          "note": "สำหรับหลักสูตรปรับปรุง พ.ศ. 2560",
          "professors": [
            "อาจารย์ ดร.คมศัลล์ ศรีวิสุทธิ์",
            "นายธนพล คงเจริญสุข",
            "นายสิทธิชัย สิริฤทธิกุลชัย",
            "นายตะวัน คำอาจ"
          ],
          "language": "TH",
          "seat": {
            "totalSeat": "40",
            "registered": "38",
            "remain": "2"
          },
          "classSchedule": [
            {
              "day": "Tu",
              "times": "09:00-12:00",
              "room": "B1139"
            },
            {
              "day": "Th",
              "times": "13:00-16:00",
              "room": "F11-422.Software"
            }
          ],
          "exams": {
            "midterm": {
              "date": "25",
              "month": "Dec",
              "times": "12:00-14:00",
              "year": "2566",
              "room": "อาคารBห้องB1115(สอบตามตารางมหาวิทยาลัย)25ธ.ค.2566"
            },
            "final": {
              "date": "14",
              "month": "Feb",
              "times": "13:00-16:00",
              "year": "2567",
              "room": "อาคารBห้องN(สอบตามตารางมหาวิทยาลัย)14ก.พ.2567"
            }
          }
        }
      ]
    }
  ]
}

Tech Stack

Go Fiber, Colly, Cache