Scola API Reference

Unified API documentation — semua endpoint backend (Odoo) yang digunakan frontend.

Konvensi

Base URL

Environment	URL
Production	https://gcgscola.id/api
Development	https://dev.gcgscola.id/api
Local	http://localhost:5173/api (proxy ke Odoo)

Frontend menggunakan same-origin proxy — semua API call melalui /api/* yang di-proxy Nginx ke Odoo backend. Lihat architecture/api-proxy.md.

Authentication

Semua endpoint (kecuali yang ditandai auth=none) memerlukan Odoo session cookie yang didapat setelah login.

# Login
POST /api/web/session/authenticate
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "params": {
    "db": "scola_production",
    "login": "username",
    "password": "password"
  }
}

Response Format

// Success
{ "success": true, "data": { ... }, "message": "..." }

// Error
{ "success": false, "error": "Error Type", "message": "..." }

API Docs per Domain

Domain	File	Endpoint Prefix
Auth & Session	auth.md	/api/web/session/, /api/v1/auth/
Dashboard	dashboard.md	/api/v1/executive/, /api/v1/dashboard/
Platform Admin	platform-admin.md	/api/v1/subscription/, /api/v1/platform/subscription/
Akademik	academic.md	/api/v1/academic/, /api/dataset/
LMS	lms.md	/api/v1/lms/
CBT	cbt.md	/api/v1/cbt/
Absensi & RFID	attendance.md	/api/rfid/, /api/v1/attendance/
Kesiswaan	kesiswaan.md	/api/v1/student/, /api/v1/counseling/
Keuangan	keuangan.md	/api/v1/fees/, /api/v1/accounting/
SPMB	spmb.md	/api/v1/admission/
SDM/HR	hr.md	/api/v1/hr/, /api/v1/payroll/
Perpustakaan	perpustakaan.md	/api/v1/library/
Inventaris	inventaris.md	/api/v1/inventory/

Maintenance rule: Setiap kali menambah/mengubah API endpoint di backend, update file yang sesuai di folder ini.