Servislerin tek tek ne yaptığı API Dokümanları sekmesinde anlatılıyor. Buradaki kartlar ise birden fazla servisin birlikte oluşturduğu uçtan uca iş akışlarını anlatır. Ayrıntı için bir kartı seçin.
Sürücüyü vardiya başlamadan önce araca planlayın; vardiya bitince ilişkiyi sonlandırın.
Araç kamerasının geçmiş kayıtlarını indirmeden, doğrudan izleyin.
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.
Sürücü kontağı açar. Sistem aracın kullanılmaya başlandığını algılar.
Araçtaki zil çalar. Sürücü henüz tanımlanmadığı için uyarı sürer.
Sürücü kendi bilgilerini girer, uygulamanız servisimizi çağırır.
Uyarı durur ve araç o andan itibaren bu sürücüye kaydedilir.
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. |
İkisi aynı anda kullanılmaz. Hem sizin zamanlayıcınız hem bizim görevimiz aynı araca komut gönderirse, sürücü çift uyarı alır ve araca gereksiz komut trafiği oluşur. Bu yüzden firmanız için yalnızca biri etkinleştirilir.
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.
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.
Sürücü formu doldurmazsa ne olur? Uyarı tek seferlik değildir; sürücü kendini tanıtana kadar belirli aralıklarla tekrarlanır (tekrar aralığı seçtiğiniz modele göre belirlenir). Araç sürülmeye devam edebilir, ancak sesli uyarı sürer.
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-0042Baş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ı. |
Sürücüyü önceden tanımlamanıza gerek yok. Gönderdiğiniz sicil numarası sistemde yoksa sürücü kaydı otomatik oluşturulur. Daha önce tanımlıysa mevcut kayıt kullanılır — mükerrer sürücü oluşmaz.
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.
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=1Servis adı yanıltıcı olabilir: adında Stop geçmesine rağmen komutun türünü state belirler — 1 çaldırır, 0 susturur.
Evet. Bu sistem aracı çalışmaz hale getirmez; sesli uyarıyla sürücüyü kendini tanıtmaya yönlendirir.
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.
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.
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.
| 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. |
Bu akış firmanıza ve araçlarınıza özel olarak etkinleştirilir ve zil donanımını destekleyen araç takip cihazları gerektirir. Kullanmak istediğinizde lütfen bizimle iletişime geçin — araçlarınızın uygunluğunu birlikte kontrol edip kurulumu yapalım.