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.
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.
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.
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 }
} ] }
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 } ] }
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 } ] }
Seferlerin listesi (en fazla 31 gün).
{ "seferler": [ { "aracId": 27, "arac": "...", "baslangic": "...", "bitis": "...", "km": 23.4,
"sureDk": 38, "azamiHiz": 91, "baslangicAdres": null, "bitisAdres": null } ] }
| Parametre | Biçim | Varsayılan |
|---|---|---|
bas | ISO 8601 (2026-11-01T06:00:00Z) ya da gün (2026-11-01 = Türkiye saatiyle gün başı) | 24 saat önce |
bit | aynı | ş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"
| Kod | Anlamı |
|---|---|
| 400 | Tarih geçersiz ya da aralık çok uzun |
| 401 | Anahtar yok, hatalı ya da iptal edilmiş |
| 403 | Hesap durdurulmuş ya da abonelik süresi dolmuş |
| 404 | Araç ya da uç bulunamadı |
| 429 | İstek sınırı aşıldı; biraz bekleyip tekrar deneyin |
Hata yanıtı: { "hata": "açıklama" }
Entegrasyonla ilgili sorularınız ve ihtiyaç duyduğunuz ek uçlar için: destek@cloudmint.com.tr