API Reference
Endpoint, autentikasi, dan format response API
Base URL
https://{domain-sekolah}/api/v1Autentikasi
API memakai token Bearer. Ambil token lewat endpoint login, lalu kirim di header setiap request.
Authorization: Bearer <token>
Accept: application/jsonLogin
curl -X POST https://contoh.sch.id/api/v1/login \
-H "Accept: application/json" \
-d "username=admin" \
-d "password=rahasia"Response sukses:
{
"success": true,
"data": {
"token": "1|abcdef...",
"user": { "id": 1, "name": "Admin" }
}
}Format response
{
"success": true,
"message": "OK",
"data": {}
}Kode status
| Kode | Arti |
|---|---|
| 200 | Berhasil |
| 401 | Belum login atau token tidak valid |
| 403 | Tidak punya akses |
| 404 | Data tidak ditemukan |
| 422 | Validasi gagal |
| 500 | Error server |
Daftar endpoint
| Method | Path | Keterangan |
|---|---|---|
| POST | /login | Login dan ambil token |
| GET | /me | Data pengguna saat ini |
| GET | /students | Daftar siswa |
| GET | /students/{id} | Detail siswa |
Ini contoh. Untuk dokumentasi otomatis dari spesifikasi OpenAPI, pertimbangkan paket fumadocs-openapi.