Panele dön

Entegrasyon API'si

Araçlarınızın konumunu, rotalarını, km ve sefer bilgilerini kendi yazılımınıza (ERP, muhasebe, lojistik planlama…) alabilirsiniz. API salt okunurdur: veri değiştirmez, yalnız okur. Tüm yanıtlar JSON, zamanlar UTC (ISO 8601), hızlar km/s'dir.

1. Anahtar alma

Panelde Hesabım → Entegrasyon (API) penceresinde (telefonda Diğer → Entegrasyon (API)) Anahtar oluştur'a basın (ana hesap ve Tam yetkili kullanıcılar görebilir). Anahtar cmt_ ile başlar ve yalnız bir kez gösterilir; güvenli bir yerde saklayın. Kullanılmayan ya da sızdığından şüphelendiğiniz anahtarı aynı yerden İptal et ile hemen geçersiz kılın. Firma başına en fazla 5 anahtar olabilir.

2. Kimlik doğrulama

Her istekte anahtarı X-API-Key başlığında (ya da Authorization: Bearer …) gönderin:

curl -H "X-API-Key: cmt_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
     https://takip.cloudmint.com.tr/api/v1/araclar

Sınır: aynı IP adresinden 10 dakikada en fazla 300 istek. Canlı konum için 30–60 saniyede bir sorgulamak yeterlidir.

3. Uçlar

GET/api/v1/araclar

Tüm araçlar ve son konumları.

{ "araclar": [ {
  "id": 27, "ad": "59 AGC 544 PEUGEOT BOXER", "plaka": "59 AGC 544", "imei": "353691849048938",
  "durum": "online",            // online | offline | unknown
  "sonVeri": "2026-11-03T08:14:05Z",
  "km": 164611,                 // gösterge kilometresi (girildiyse düzeltilmiş)
  "konum": { "zaman": "2026-11-03T08:14:02Z", "enlem": 41.32285, "boylam": 27.98178,
             "hiz": 54, "yon": 87, "kontak": true }
} ] }

GET/api/v1/araclar/{id}/rota?bas=…&bit=…

Bir aracın belirtilen aralıktaki konum noktaları (en fazla 7 gün).

{ "noktalar": [ { "zaman": "...", "enlem": 41.3, "boylam": 27.9, "hiz": 48, "kontak": true } ] }

GET/api/v1/rapor?bas=…&bit=…

Araç başına özet (en fazla 31 gün).

{ "araclar": [ { "aracId": 27, "arac": "59 AGC 544 PEUGEOT BOXER", "km": 412.6, "sefer": 9,
                 "motorDk": 731, "azamiHiz": 112, "ortalamaHiz": 46, "hizAsimi": 3 } ] }

GET/api/v1/seferler?bas=…&bit=…

Seferlerin listesi (en fazla 31 gün).

{ "seferler": [ { "aracId": 27, "arac": "...", "baslangic": "...", "bitis": "...", "km": 23.4,
                  "sureDk": 38, "azamiHiz": 91, "baslangicAdres": null, "bitisAdres": null } ] }

4. Tarih parametreleri

ParametreBiçimVarsayılan
basISO 8601 (2026-11-01T06:00:00Z) ya da gün (2026-11-01 = Türkiye saatiyle gün başı)24 saat önce
bitaynışimdi

Örnek — 1 Kasım gününün özeti:

curl -H "X-API-Key: $ANAHTAR" "https://takip.cloudmint.com.tr/api/v1/rapor?bas=2026-11-01&bit=2026-11-02"

5. Hatalar

KodAnlamı
400Tarih geçersiz ya da aralık çok uzun
401Anahtar yok, hatalı ya da iptal edilmiş
403Hesap durdurulmuş ya da abonelik süresi dolmuş
404Araç ya da uç bulunamadı
429İstek sınırı aşıldı; biraz bekleyip tekrar deneyin

Hata yanıtı: { "hata": "açıklama" }

Destek

Entegrasyonla ilgili sorularınız ve ihtiyaç duyduğunuz ek uçlar için: destek@cloudmint.com.tr