REST API · JSON

Servis API

Okul servisi yönetim sistemi REST API. Roller: admin, firma, şoför, hostes. Hiyerarşik kullanıcı yönetimi. Tüm parametreler JSON body içinde gönderilir.

🔐

Kimlik Doğrulama

Laravel Sanctum Bearer token ile güvenli API erişimi. Token 24 saat geçerlidir; süresi dolmadan tekrar giriş yapılırsa aynı token döner.

Authorization: Bearer {token}

{ }

JSON Body

Tüm endpoint'ler POST metodu ile çalışır. Parametreler her zaman JSON body içinde gönderilir. Content-Type: application/json header'ı zorunludur.

Content-Type: application/json

📱

Web & Mobil

Aynı API hem web paneli hem iOS/Android mobil uygulamalar için tasarlandı. JSON formatında tutarlı yanıtlar.

⚡

Hızlı Başlangıç

Test kullanıcıları ile hemen deneyin. Sol menüden endpoint seçerek detaylı örnekleri inceleyin.

Hiyerarşi

Admin → Admin, Firma, Şoför (firmaya), Hostes (şoföre)
Firma → Şoför (otomatik parent_id)
Şoför → Hostes (otomatik parent_id)

Kullanıcı Rolleri

Admin

admin

Tüm kullanıcıları yönetir; admin, firma, şoför, hostes ekleyebilir

Firma

firma

Kendi firmasına şoför ve veli ekler; veli başvuru QR kodunu indirir

Şoför

sofor

Kendi ekibine hostes ekler; rotaları yönetir

Hostes

hostes

Servis ekibinde görev alır; rotaları yönetir

Yanıt Formatı

{
    "success": true,
    "message": "İşlem mesajı",
    "data": "..."
}

{
    "success": false,
    "message": "Hata mesajı",
    "errors": "Doğrulama hataları (opsiyonel)"
}

Test Hesapları

Rol	E-posta	Şifre
Admin	`admin@servis.com`	`password123`
Firma	`firma@servis.com`	`password123`
Şoför	`sofor@servis.com`	`password123`
Hostes	`hostes@servis.com`	`password123`