REST API ile neler yapabilirsiniz?
- Okuma: İstasyonlar ve soket durumları, aktif ve geçmiş şarj seansları, sürücüler, RFID kartlar, araçlar, uyarılar ve reddedilen kart okutmaları.
- Yazma: Sürücü, RFID kart ve araç ekleyin, güncelleyin, silin — örneğin İK sisteminizden personeli otomatik tanımlayın.
- Komut: Şarjı uzaktan durdurun, cihazı yeniden başlatın, soket kilidini açın; komutun sonucunu takip edin.
- Raporlar: Gün, ay, istasyon, sürücü veya araç bazında enerji raporu alın.
Webhook ile anlık olaylar
Sürekli sorgu atmak yerine olaylar gerçekleştiği anda sunucunuza gelir: session.started, session.stopped, connector.status_changed, station.connected, station.disconnected, auth.rejected, alert.created ve command.completed. Her istek HMAC-SHA256 ile imzalanır; başarısız gönderimler otomatik olarak tekrar denenir.
Kurumsal güvenlik
- Yetki kapsamları (okuma, yazma, komut) ile en az yetki prensibi
- IP izin listesi ve son kullanma tarihi olan anahtarlar
- Anahtar başına istek sınırı, tüm isteklerin kayıt altında tutulması
- Anahtarlar sunucuda şifrelenmiş (hash) olarak saklanır
Geliştirici belgeleri
Tüm uç noktalar; cURL, PHP, Node.js ve Python örnekleriyle birlikte Türkçe ve İngilizce belgelenmiştir. API anahtarınızı panelde API Ayarları sayfasından dakikalar içinde oluşturabilirsiniz.
Sık sorulan sorular
API kullanımı ek ücretli mi?
Hayır. API ve webhook tüm hesaplarda standart olarak sunulur.
Hangi formatta veri döner?
Tüm yanıtlar JSON formatındadır; tarihler saat dilimiyle birlikte ISO-8601 olarak verilir.
Webhook almak için sunucum yoksa?
Aynı olayları olay akışı uç noktasından periyodik olarak da çekebilirsiniz.