🎓 Report Card Generator API

RESTful API for School Management & Report Card Generation

35+

API Endpoints

9

Modules

REST

Architecture

🔐 Authentication

POST /api/auth/register Public

Register a new school account

POST /api/auth/login Public

Login to school account

POST /api/auth/logout Auth Required

Logout from current session

GET /api/auth/check-session Auth Required

Check if school session is valid

POST /api/auth/teacher-login Public

Login to teacher account

GET /api/auth/teacher-check-session Auth Required

Check if teacher session is valid

👨‍🎓 Students & Reports

GET /api/generate-admission-number Auth Required

Generate unique admission number for new student

POST /api/create-student Auth Required

Create a new student record

POST /api/save-report Auth Required

Save or update student report card

GET /api/get-report Auth Required

Get student report card by ID

GET /api/get-all-students Auth Required

Get all students for current school

POST /api/delete-report Auth Required

Delete a student report

GET /api/check-student Auth Required

Check if student exists by admission number

GET /api/get-student-profile Auth Required

Get complete student profile with all reports

🏫 School Management

GET /api/school/get-profile Auth Required

Get school profile information

POST /api/school/update-profile Auth Required

Update school profile details

POST /api/school/update-logo Auth Required

Upload/update school logo

POST /api/school/update-settings Auth Required

Update school settings and preferences

POST /api/school/change-password Auth Required

Change school account password

👨‍🏫 Teacher Management

POST /api/teachers/create Auth Required

Create a new teacher account

GET /api/teachers/get-all Auth Required

Get all teachers for current school

POST /api/teachers/assign-class Auth Required

Assign a class to a teacher

GET /api/teachers/get-my-classes Auth Required

Get classes assigned to current teacher

📋 Attendance

GET /api/attendance/get-students Auth Required

Get students for attendance marking

POST /api/attendance/mark-daily Auth Required

Mark daily attendance for students

GET /api/attendance/get-daily Auth Required

Get attendance records for a specific date

📊 Analytics

GET /api/get-analytics Auth Required

Get dashboard analytics (top students, class performance, grade distribution)

💳 Subscription & Payments

GET /api/subscription/get-plans Auth Required

Get available subscription plans

POST /api/subscription/initialize-payment Auth Required

Initialize Paystack payment for subscription

GET /api/subscription/verify-payment Auth Required

Verify payment transaction with Paystack

GET /api/subscription/get-status Auth Required

Get current subscription status

🔄 Auto-Debit & Recurring Payments

POST /api/auto-debit/enable Auth Required

Enable auto-debit after successful payment

GET /api/auto-debit/manage Auth Required

Get auto-debit status and history

POST /api/auto-debit/manage Auth Required

Update auto-debit settings

GET /api/process-auto-debit Cron Job

Process auto-debits (scheduled daily via cron)

📄 PDF Generation

POST /api/generate-pdf Auth Required

Generate PDF report card

GET /api/pdf-view Public

HTML view for PDF generation (used by Puppeteer)