Sürüm Notları
2026-07-27
Geliştirici portalı yenilendi
- Portal iki dilli hale getirildi: Türkçe ve İngilizce içerik ayrı adreslerde (
/tr,/en) yayınlanıyor. - Arayüz metinleri, API referansı ve yanıt sözleşmeleri seçilen dile göre çeviriliyor.
- Dokümantasyon araması (Pagefind) devreye alındı; her iki dil ayrı indeksleniyor.
- Okunabilirlik odaklı tasarım revizyonu: kontrast, kart yapısı, canlı deneme formu ve koyu tema düzeltildi.
- Konum, taşıyıcı, alıcı, alarm şablonu ve sevkiyat şablonu kaynaklarında
PATCH(kısmi güncelleme) sözleşmesi belgelendi; bu işlemler API’de zaten destekleniyordu. - Her API işlemi için kalıcı bağlantı (
#endpoint-id) eklendi.
2026-07-25
Genişletilmiş müşteri API’si
- Konum, taşıyıcı, alıcı, alarm şablonu ve sevkiyat şablonu CRUD sözleşmeleri eklendi.
- Cihaz durumu, müşteri ayarları, alarm, telemetri ve bakım geçmişi uçları eklendi.
- Sevkiyat oluşturma, tamamlama, paylaşma ve takip verisi sözleşmeleri eklendi.
- Rapor, kullanıcı, rol ve güvenli kullanıcı daveti sözleşmeleri eklendi.
- Kayıt oluşturan
POSTişlemlerine kalıcı idempotency koruması eklendi. - Public API ve resmî mobil uygulama kimlik doğrulama modelleri birbirinden ayrıldı.
Rehber ve API referansı ayrımı
- Kavramsal rehberler Dokümantasyon altında toplandı.
- Kesin sözleşmeler ve kod örnekleri API Referansı alanına taşındı.
- İstemci kimlik bilgileri, 1 saatlik erişim jetonu, yetki kapsamı ve hesap izin listesi güvenlik modeli eklendi.
- Public API v1 müşteri sözleşmesi
/api/public/v1altında yayınlandı. - Canlı istek deneme alanı açıldı.
2026-07-24
Geliştirici portalı ilk müşteri sürümü
- Mobil ve web entegrasyon rehberleri eklendi.
- Cihaz, telemetri, alarm, sevkiyat ve hesap kaynakları gruplandı.
- Müşteri yetki sınırı (tenant scope) ve rol izinleri belgelendi.
- Sayfalama, hata ve webhook güvenlik rehberleri eklendi.
Sürümleme politikasının temel ilkeleri
API URL yolu ana sürümü taşır:
/api/public/v1Yeni alan eklenmesi geriye uyumlu kabul edilir. Alan kaldırma, alan adı değiştirme veya davranış kırılması yeni ana sürüm gerektirir.