Subject

Program Semesters API

Base URL: http://192.168.100.250/

---

Endpoints

Method	Endpoint	Description
GET	/programs/{programId}/semesters	List semesters for a program
POST	/programs/{programId}/semesters	Create semester
PUT	/programs/{programId}/semesters/{semesterId}	Update semester
DELETE	/programs/{programId}/semesters/{semesterId}	Delete semester
GET	/getProgram?faculty_id={facultyId}&level_id={levelId}	Get programs by faculty/level
GET	/getSemester?program_id={programId}	Get semesters by program

---

List Semesters

GET /programs/{programId}/semesters?page=1
Accept: application/json

---

Create Semester

POST /programs/{programId}/semesters
Content-Type: application/json

Request Body:

{
  "semester_number": 1,
  "name": "First Semester"
}

---

Update Semester

PUT /programs/{programId}/semesters/{semesterId}
Content-Type: application/json

Request Body:

{
  "semester_number": 1,
  "name": "First Semester"
}

---

Delete Semester

DELETE /programs/{programId}/semesters/{semesterId}

---

Helpers (Filter Dropdowns)

Get Programs by Faculty/Level

GET /getProgram?faculty_id=36&level_id=1
Accept: application/json

Get Semesters by Program

GET /getSemester?program_id=1
Accept: application/json

---

Semester Subjects

Method	Endpoint
GET	/programs/{programId}/semesters/{semesterId}/subjects
POST	/programs/{programId}/semesters/{semesterId}/subjects
PUT	/programs/{programId}/semesters/{semesterId}/subjects/{subjectId}
DELETE	/programs/{programId}/semesters/{semesterId}/subjects/{subjectId}

---

Subject API

Base URL: http://192.168.100.250/

---

Endpoints

Method	Endpoint	Description
GET	/subjects	List all subjects
POST	/subjects	Create subjects (bulk)
PUT	/subjects/{id}	Update subject
DELETE	/subjects/{id}	Delete subject
GET	/programs/{programId}/semesters/{semesterId}/subjects	List subjects in semester
POST	/programs/{programId}/semesters/{semesterId}/subjects	Add subjects to semester
PUT	/programs/{programId}/semesters/{semesterId}/subjects/{subjectId}	Update semester subject
DELETE	/programs/{programId}/semesters/{semesterId}/subjects/{subjectId}	Remove subject from semester

---

List

GET /subjects
Accept: application/json

---

Create (Bulk)

POST /subjects
Content-Type: application/json

Request Body:

{
  "subjects": [
    { "name": "Mathematics I", "code": "MTH101", "description": "Basic maths" },
    { "name": "Physics I", "code": "PHY101" }
  ]
}

---

Update

PUT /subjects/{id}
Content-Type: application/json

Request Body:

{
  "name": "Advanced Mathematics",
  "code": "MTH201",
  "description": "Advanced level mathematics"
}

---

Delete

DELETE /subjects/{id}

---

Program Semester Subjects

List Subjects in Semester

GET /programs/{programId}/semesters/{semesterId}/subjects?page=1
Accept: application/json

Add Subjects to Semester

POST /programs/{programId}/semesters/{semesterId}/subjects
Content-Type: application/json

Request Body:

{
  "subjects": [
    {
      "subject_id": 1,
      "code": "MTH101",
      "type": "compulsory",
      "full_mark": 100,
      "pass_mark": 35,
      "credit_hr": 3
    }
  ]
}

Update Semester Subject

PUT /programs/{programId}/semesters/{semesterId}/subjects/{subjectId}
Content-Type: application/json

Request Body:

{
  "credit_hr": 4,
  "type": "elective",
  "code": "MTH201",
  "full_mark": 100,
  "pass_mark": 40
}

Remove Subject from Semester

DELETE /programs/{programId}/semesters/{semesterId}/subjects/{subjectId}