API Dokümantasyonu

Kullanıcı girişi yapar ve API tokeni döndürür.

{
    "message": "Giriş başarılı.",
    "user": {
        "id": 2,
        "name": "Ahmet",
        "surname": "Yilmaz",
        "email": "ahmet.yilmaz@yoklama.edu.tr",
        "student_number": null,
        "role": "instructor"
    },
    "token": "1|abc123..."
}

Mevcut tokeni siler ve oturumu sonlandırır.

{
    "message": "Çıkış başarılı."
}

Giriş yapmış kullanıcının profil bilgilerini döndürür.

{
    "user": {
        "id": 4,
        "name": "Mehmet",
        "surname": "Kaya",
        "full_name": "Mehmet Kaya",
        "email": "mehmet.kaya@stu.yoklama.edu.tr",
        "student_number": "2021001",
        "role": "student"
    }
}

Kullanıcının şifresini günceller.

Öğrencinin kayıtlı olduğu derslerdeki aktif yoklama oturumlarını listeler. Aktif oturum yoksa bilgi mesajı döner.

{
    "sessions": [
        {
            "session_id": 1,
            "course_code": "BIL101",
            "course_name": "Bilgisayar Bilimine Giris",
            "started_at": "14:30",
            "expires_at": "15:00",
            "remaining_minutes": 22.5
        }
    ]
}

QR kod ve GPS konum ile çift katmanlı yoklama doğrulaması yapar. Sistemin en kritik endpointidir.

{
    "success": true,
    "message": "Yoklama kaydınız başarıyla alındı.",
    "record": {
        "course": "Bilgisayar Bilimine Giris",
        "verified_at": "14:32:15",
        "qr_verified": true,
        "gps_verified": true,
        "result": "present"
    }
}

{
    "success": false,
    "message": "Konum sınıf dışında. Mesafe: 589 metre (izin verilen: 50 metre)",
    "error_code": "GPS_OUT_OF_RANGE",
    "record": {
        "qr_verified": true,
        "gps_verified": false,
        "distance_meters": 589.03,
        "allowed_radius": 50,
        "result": "failed_gps"
    }
}

Öğrencinin geçmiş yoklama kayıtlarını listeler. Opsiyonel course_id parametresi ile ders bazlı filtreleme yapılabilir.

Öğrencinin tüm derslerindeki katılım özetini döndürür: toplam oturum, katılım, devamsızlık ve katılım oranı.

{
    "summary": [
        {
            "course_code": "BIL101",
            "course_name": "Bilgisayar Bilimine Giris",
            "total_sessions": 12,
            "attended": 10,
            "absent": 2,
            "attendance_rate": 83.3
        }
    ]
}

Öğretim elemanının aktif derslerini öğrenci sayısıyla birlikte listeler.

Derse öğrenci ekleme ekranında kullanılacak öğrenci listesini döner; derse kayıtlı olanları da işaretler.

Yeni ders oluşturur ve dersi oluşturan öğretim elemanını otomatik olarak dersin öğretmeni yapar.

Seçilen öğrenciyi derse ekler. Ekrandaki seçim listesi aynı ders için kayıtlı öğrencileri de gösterir.

Yeni bir yoklama oturumu başlatır. Dinamik QR token otomatik üretilir.

{
    "message": "Yoklama oturumu başlatıldı.",
    "session": {
        "id": 1,
        "qr_token": "QvlpFZ0ob3xAJ0sM2uApLD...",
        "qr_refresh_seconds": 30,
        "started_at": "2026-03-23T14:30:00+00:00",
        "expires_at": "2026-03-23T15:00:00+00:00",
        "latitude": "39.9255330",
        "longitude": "32.8662870",
        "radius_meters": 50
    }
}

Aktif oturumun QR tokenini manuel olarak yeniler. Yeni token ve geçerlilik süresi döner.

Yoklama oturumunu sonlandırır. Katılım özeti döner.

{
    "message": "Yoklama oturumu sonlandırıldı.",
    "summary": {
        "present": 8,
        "absent": 2,
        "total": 10
    }
}

Yoklama sırasında anlık katılım durumunu döndürür. Öğrenci listesi, doğrulama durumları ve mesafe bilgilerini içerir.

{
    "session_id": 1,
    "status": "active",
    "is_active": true,
    "present_count": 1,
    "absent_count": 9,
    "total_students": 10,
    "records": [
        {
            "student_number": "2021001",
            "name": "Mehmet",
            "surname": "Kaya",
            "verified_at": "14:32:15",
            "qr_verified": true,
            "gps_verified": true,
            "result": "present",
            "distance_meters": "0.82"
        }
    ]
}

Geçmiş yoklama oturumlarını ders ve tarih aralığı bazında listeler.

Yoklama kayıtlarını Excel (.xlsx) dosyası olarak indirir. Sütunlar: Öğrenci No, Ad, Soyad, Ders, Tarih, Saat, QR Durumu, GPS Durumu, Sonuç, Mesafe, Devamsızlık Oranı, Toplam Katılım, Öğretmen Notu.

Kullanıcılar listelenir (sayfalandırılmış). role ve search parametreleri ile filtrelenir.

Yeni kullanıcı oluşturur (öğrenci, öğretim elemanı veya admin).

Yeni ders oluşturur. Ayrıca POST /admin/courses/assign-student ve POST /admin/courses/assign-instructor endpointleri ile kullanıcılar derslere atanır.

Yeni derslik oluşturur. Enlem, boylam ve varsayılan kabul yarıçapı tanımlanır.