← Senaryolar

Sürücü Tanımlama Zili (Buzzer) ile Sürücü Takibi

Bu senaryo, aracı kimin kullandığını kesin olarak bilmek isteyen filolar içindir. Araç çalıştırıldığında araç içindeki zil (buzzer) ötmeye başlar; sürücü kendi uygulamanızdaki formu doldurup kendini tanıttığında zil susar ve o sürücü araca atanır.

Böylece sürücü tanımlaması isteğe bağlı bir adım olmaktan çıkar: araç, sürücü kendini tanıtana kadar sesli uyarı vermeye devam eder. Sonuçta mesafe, sürüş ve davranış raporları doğru sürücüye işlenir.

Bir bakışta

Akış şeması

İki çalışma modeli

Zili çaldıran adım firma bazında yapılandırılır. Kurulum sırasında birlikte karar veririz; sonradan da değiştirilebilir.

	A) Siz yönetirsiniz (API)	B) Biz otomatikleştiririz
Zili kim çaldırır?	Uygulamanız, BuzzerCompanyDeviceStop servisini state=1 ile çağırır.	Sunucumuzdaki zamanlanmış görev, firmanız için otomatik çağırır.
Hangi araçlara?	Siz seçersiniz — plates ile istediğiniz plakalar.	Formu doldurulmamış araçlar otomatik seçilir.
Tekrar aralığı	Kendi zamanlayıcınızda belirlersiniz.	Bizim tarafımızda ayarlanır (ör. 20 dakika).
Sizde gereken	Periyodik çalışan bir görev (cron/zamanlayıcı).	Yok — yalnızca susturma çağrısını yaparsınız.
Uygun olduğu durum	Vardiya saatlerini, istisnaları ve kapsamı kendiniz yönetmek istiyorsanız.	Ek geliştirme yapmadan, hazır bir kurulum istiyorsanız.

Susturma tarafı her iki modelde de aynıdır: sürücü formu doldurduğunda uygulamanız Buzzer servisini state=0 ile çağırır (aşağıdaki 2. adım). Model seçimi yalnızca çaldırma adımını etkiler.

Adım adım

1. Zil ötmeye başlar

Zilin ne zaman çalacağı, aşağıdaki iki çalışma modelinden hangisini seçtiğinize bağlıdır. İkisi de aynı sonucu verir; fark, uyarıyı kimin başlattığıdır.

2. Sürücü formu doldurur, zil susar

Sürücü kendi bilgilerini girdiğinde uygulamanız Buzzer servisini state=0 (sustur) ile çağırır. Sürücü bilgilerini de aynı çağrıda gönderirseniz sürücü tek adımda araca atanır.

POST https://api.takip724.com/Buzzer
    ?token=SIZE_VERILEN_TOKEN
    &plate=34XY9001
    &state=0
    &driverName=Ornek
    &driverSurName=Surucu
    &driverIdNumber=EMP-0042

Başarılı yanıt:

{ "code": 1, "message": "İşlem başarıyla gerçekleştirilmiştir." }

Alan	Zorunlu	Açıklama
plate	Evet	Sürücünün kullandığı aracın plakası.
state	Hayır	0 sustur, 1 çaldır. Varsayılan 0.
driverIdNumber	Hayır	Sürücünün sicil/personel numarası. Sürücü atamasının anahtarıdır — gönderilmezse yalnızca zil susar, atama yapılmaz.
driverName / driverSurName	Hayır	Sürücünün adı ve soyadı.

3. Sürücü araca atanır

Atama anında yapılır. Araçta önceden başka bir sürücü tanımlıysa o ilişki kaldırılır; bir aracın her zaman tek bir güncel sürücüsü olur.

4. Vardiya veya gün sonunda sıfırlama

Vardiya bittiğinde BuzzerCompanyDeviceStop servisiyle birden fazla aracı tek çağrıda işleyebilirsiniz. Bu, ertesi vardiyada sürücülerin yeniden tanımlanmasını sağlar.

POST https://api.takip724.com/BuzzerCompanyDeviceStop
    ?token=SIZE_VERILEN_TOKEN
    &plates=34XY9001,34XY9002,34XY9003
    &state=1

Sık sorulan sorular

Sürücü formu doldurmadan aracı kullanabilir mi?

Evet. Bu sistem aracı çalışmaz hale getirmez; sesli uyarıyla sürücüyü kendini tanıtmaya yönlendirir.

Aynı sürücü gün içinde birden fazla araç kullanırsa?

Her araç için ayrı çağrı yapmanız yeterlidir. Aynı sicil numarası tekrar gönderildiğinde yeni sürücü kaydı oluşturulmaz, mevcut sürücü ilgili araca atanır.

Sürücüyü form olmadan, önceden atayabilir miyim?

Evet. İleri tarihli planlama için DriverDeviceBooking, anında atama için DriverDeviceAssign servislerine bakabilirsiniz. Bu senaryodaki fark, atamanın sürücünün kendi doldurduğu form üzerinden yapılmasıdır.

Çağrıyı çok sık tekrarlarsam ne olur?

Servislerimizde aşırı istek koruması vardır: Buzzer için 10 saniyede 1 istek, BuzzerCompanyDeviceStop için saniyede 5 istek sınırı aşılırsa -999 kodu döner. Aynı araç için aynı komut zaten sırada bekliyorsa tekrar gönderilmez.

Karşılaşabileceğiniz hata kodları

Kod	Anlamı	Ne yapmalı?
1	İşlem başarılı	—
3001	Plaka boş gönderildi	plate alanını doldurun.
5000	Plaka bulunamadı veya firmanıza ait değil	Plakayı sistemde tanımlı yazımıyla gönderin.
2008	Token geçersiz	Size verilen erişim kodunu kontrol edin.
-999	Çok sık istek	Kısa bir süre bekleyip tekrar deneyin.

Başlamadan önce

← Senaryolar

Sürücü Rezervasyonu ile Vardiya Planlama

Bu senaryo, sürücüsü vardiyaya göre değişen ve kimin hangi araca bineceğini önceden planlayan filolar içindir. Kendi planlama veya rezervasyon sisteminizden “bu sürücü, bu araca, şu saatte binecek” bilgisini önceden gönderirsiniz; saat geldiğinde sürücü araca otomatik atanır, vardiya bittiğinde de ilişkiyi kapatırsınız.

Böylece mesafe, sürüş ve davranış raporları gerçekten o saatte aracı kullanan sürücüye işlenir; vardiya sonrasındaki hareketler (aracın depoya çekilmesi, bakım) yanlışlıkla son sürücüye yazılmaz.

Bir bakışta

Akış şeması

Anında atama mı, rezervasyon mu?

Sürücüyü araca bağlamanın iki yolu vardır. Bu senaryo rezervasyonu anlatır; anında atama, planlama gerektirmeyen durumlar için daha basittir.

	Anında atama	Rezervasyon
Ne zaman geçerli olur?	Çağrı anında.	bookingDate geldiğinde (en geç ~1 dakika içinde).
Önceden planlama	Yok — atamayı yapmak için o anı beklemeniz gerekir.	Var — günler öncesinden gönderebilirsiniz.
Değiştirme / iptal	Yeni bir atama yaparak.	Aynı bookingId ile yeniden göndererek ya da iptal servisiyle.
Raporu tek vardiyaya süzme	Yok.	bookingId ile.

Adım adım

1. Rezervasyonu oluşturun

Planlama sisteminizde bir vardiya oluştuğunda DriverDeviceBooking servisini çağırın. bookingId, sizin sisteminizdeki rezervasyonun kalıcı kimliğidir; aynı rezervasyonu daha sonra değiştirmek, iptal etmek, vardiyasını kapatmak ya da raporunu almak için hep bu değeri kullanırsınız.

POST https://api.takip724.com/DriverDeviceBooking
    ?token=SIZE_VERILEN_TOKEN
    &identityNumber=12345678901
    &plate=34XY9001
    &bookingId=BK-1001
    &bookingDate=2026-10-05 07:30:00

Başarılı yanıt:

{
  "code": 1002,
  "message": "Success",
  "driver":  { "id": "1024", "name": "12345678901", "surname": "-", "identityNumber": "12345678901" },
  "device":  { "deviceId": "134795", "plate": "34XY9001", "uniqueId": "868324021171637" },
  "booking": { "bookingId": "BK-1001", "bookingDate": "2026-10-05 07:30:00",
               "bookingDateUtc": "2026-10-05 04:30:00", "driverId": "1024", "deviceId": "134795" }
}

Alan	Zorunlu	Açıklama
identityNumber	Evet	Sürücünün kimlik/sicil numarası. Sürücü eşleştirmesinin anahtarıdır.
plate	Evet	Aracın plakası.
bookingId	Evet	Sizin sisteminizdeki rezervasyon kodu (ör. BK-1001).
bookingDate	Evet	Sürücünün araca atanacağı an: YYYY-MM-DD HH:mm:ss, kendi saat diliminizde.

2. Gerekirse değiştirin ya da iptal edin

Plan değişirse aynı bookingId ile servisi yeniden çağırın: henüz zamanı gelmemiş eski rezervasyon geçersiz olur ve son gönderdiğiniz geçerli olur (araç, sürücü ya da saat farklı olabilir). Birebir aynı bilgiyi tekrar göndermek hiçbir şeyi değiştirmez — isteği güvenle yineleyebilirsiniz.

Vardiya tamamen iptal olduysa DriverDeviceBookingCancel servisine yalnızca bookingId gönderin:

POST https://api.takip724.com/DriverDeviceBookingCancel
    ?token=SIZE_VERILEN_TOKEN
    &bookingId=BK-1001

3. Saati gelince sürücü araca atanır

Rezervasyonlar arka planda düzenli olarak kontrol edilir; bookingDate geçtiğinde sürücü en geç yaklaşık 1 dakika içinde araca atanır. Araçta önceden başka bir sürücü varsa bu ilişki kaldırılır — bir aracın her zaman tek bir güncel sürücüsü olur.

Aynı araca gün içinde farklı saatler için farklı sürücüler planlayabilirsiniz (her biri ayrı bookingId ile). Rezervasyonlar birbirini etkilemez; her biri kendi saatinde işlenir.

4. Durumu takip edin

DriverDeviceBookingList ile rezervasyonların hangi aşamada olduğunu görebilirsiniz. plate, identityNumber ve startDate/endDate ile süzebilir, history=1 ile geçmiş kayıtları da alabilirsiniz.

GET https://api.takip724.com/DriverDeviceBookingList
    ?token=SIZE_VERILEN_TOKEN
    &plate=34XY9001
    &startDate=2026-10-05 00:00:00
    &endDate=2026-10-05 23:59:59

processStatus	Anlamı
0	Bekliyor — saati henüz gelmedi.
1	İşlendi — sürücü araca atandı.
2	Geçersiz — aynı bookingId ile yeni rezervasyon gönderildi ya da iptal edildi.

5. Vardiya bitince kapatın

Sürücü araçtan indiğinde DriverDeviceEndShift ile vardiya sonunu bildirin. Bunu yapmazsanız atama bir sonraki rezervasyona kadar süresiz geçerli kalır ve vardiya sonrasındaki hareketler (aracın depoya çekilmesi, başka birinin kullanması) o sürücüye yazılır.

POST https://api.takip724.com/DriverDeviceEndShift
    ?token=SIZE_VERILEN_TOKEN
    &plateNo=34XY9001
    &driverId=12345678901
    &bookingId=BK-1001
    &shiftEndDate=2026-10-05 15:45:00

6. Raporları alın

Araç bazında DeviceDriverSummaryReport, sürücü bazında DriverDeviceSummaryReport kullanın. interval=1 her sürüşü, 2 günlük özeti, 3 tüm aralığın toplamını verir; günlük ve toplam satırlardaki başlangıç/bitiş saatleri pratikte vardiya başlangıç/bitiş saatidir.

GET https://api.takip724.com/DeviceDriverSummaryReport
    ?token=SIZE_VERILEN_TOKEN
    &plate=34XY9001
    &startDate=2026-10-05 00:00:00
    &endDate=2026-10-05 23:59:59
    &interval=2
    &bookingId=BK-1001

Opsiyonel alan	Ne işe yarar?
bookingId	Sonucu tek bir rezervasyona (vardiyaya) sınırlar.
minDistanceKm	Bu mesafenin (km) altındaki kısa sürüşleri — depo içi manevra, bakım — rapordan çıkarır.

Sık sorulan sorular

Geçmiş bir saat gönderirsem ne olur?

Rezervasyon reddedilmez; bir sonraki kontrolde (en geç ~1 dakika içinde) işlenir ve sürücü araca atanır.

Aynı sürücü aynı gün farklı araçlara binebilir mi?

Evet. Her biniş için ayrı bir bookingId ile rezervasyon gönderin.

Vardiyayı kapatmayı unutursam?

Bir sonraki rezervasyon işlendiğinde araç yeni sürücüye geçer; aradaki hareketler önceki sürücüye yazılır. Kısa hareketleri rapordan çıkarmak için minDistanceKm kullanabilirsiniz.

Rezervasyonun saatini sonradan değiştirebilir miyim?

Henüz işlenmediyse evet: aynı bookingId ile yeni saati gönderin. İşlendikten sonra gönderilen bilgi yeni bir rezervasyon olarak işlenir.

Rezervasyon ile anında atamayı birlikte kullanabilir miyim?

Teknik olarak evet; ancak bir aracın her zaman tek güncel sürücüsü olduğu için en son işlenen atama geçerli olur. Karışıklığı önlemek için aynı araçlarda tek yöntem kullanmanızı öneririz.

Karşılaşabileceğiniz hata kodları

Kod	Anlamı	Ne yapmalı?
1002	İşlem başarılı (rezervasyon, iptal, vardiya sonu)	—
3001	Plaka boş gönderildi	plate / plateNo alanını doldurun.
3023	Kimlik numarası boş gönderildi	identityNumber alanını doldurun.
5000	Plaka bulunamadı veya firmanıza ait değil	Plakayı sistemde tanımlı yazımıyla gönderin.
5003	İptal edilecek bekleyen rezervasyon yok	Rezervasyon işlenmiş olabilir; vardiya sonu bildirin.
3030 / 3031 / 3032	bookingId (3030), shiftEndDate (3031) veya driverId (3032) boş/geçersiz	İlgili alanı doldurun; tarihi YYYY-MM-DD HH:mm:ss biçiminde gönderin.
3033	Bu sürücü numarasıyla firmanızda sürücü yok	Rezervasyonda gönderdiğiniz identityNumber değerinin aynısını driverId olarak gönderin.
5002	Plaka/sürücü/rezervasyon üçlüsüne ait bekleyen rezervasyon yok veya vardiya zaten kapatılmış	plateNo, driverId ve bookingId rezervasyondakiyle aynı mı kontrol edin; vardiya zaten kapalıysa işlem gerekmez.
-1	Beklenmeyen hata	Yanıttaki açıklamayı okuyun; sürerse bize bildirin.
2001	Token boş veya geçersiz	Size verilen erişim kodunu kontrol edin.
-999	Çok sık istek	Kısa bir süre bekleyip tekrar deneyin.

Başlamadan önce