Sınırlar
Tazelik ve okuma aralığı
Hesaplar bankadan belirli aralıklarla okunur; veri anlık değildir. İki okuma arasındaki en kısa süre bağlantıya göre değişir ve her hesabın freshness.minSyncIntervalSeconds alanında verilir. Kodunuzda sabit bir süre varsaymayın; bu alanı okuyun.
Para hesabınıza düştükten sonra hareketin API'de ve webhook'ta görünmesi için iki şey gerekir: bankanın hareketi bildirmesi ve hesabın bir sonraki okuması. Hareketin ne zaman kaydedildiğini receivedAt alanından görebilirsiniz. → Kavramlar › Tazelik
Şimdi Yenile okuma aralığını kısaltmaz; aralık dolmadıysa okuma nextSyncAvailableAt zamanına planlanır.
Şimdi yenile istek limiti
| Uç | Limit | Kapsam |
|---|---|---|
POST /api/v1/bank-connect/accounts/{accountId}/sync | Dakikada 6 istek | API anahtarı başına |
Limit aşıldığında istek 429 RATE_LIMITED döner. Yanıtın Retry-After başlığı ve details.retryAfterSeconds alanı kaç saniye beklemeniz gerektiğini verir; bu süreye uyun. Okuma uçları (GET) bu limite sayılmaz. → Hız Limitleri
Limit, okuma aralığından ayrıdır. Limitin altında kalsanız da okuma minSyncIntervalSeconds aralığından sık yapılmaz; aynı hesap için art arda istek göndermenin yararı yoktur.
Para transferi ve döviz limitleri
| Uç | Limit | Kapsam |
|---|---|---|
POST /api/v1/bank-connect/transfers, POST /api/v1/bank-connect/fx/quotes, POST /api/v1/bank-connect/fx/orders | Üçü birlikte dakikada 20 istek | API anahtarı başına |
Limit aşıldığında istek 429 RATE_LIMITED döner; Retry-After başlığı ve details.retryAfterSeconds alanı kaç saniye beklemeniz gerektiğini verir. Okuma uçları (GET) bu limite sayılmaz. Bu limit Lunixi'nin uygulama limitidir; bankanızın transfer ve döviz limitlerinin yerine geçmez. Banka limiti aşılırsa transfer bank_connect.transfer.limit_exceeded, döviz işlemi bank_connect.fx.limit_exceeded sonuç koduyla başarısız olur.
Panelde aynı işlemler kullanıcı başına sınırlanır:
| Panel işlemi | Limit |
|---|---|
| Transfer başlatma, döviz teklifi ve işlemi | Kullanıcı başına dakikada 20 |
| Doğrulama kodunu onaylama ve yeni kod isteme | Kullanıcı başına dakikada 10 |
| Yeni doğrulama kodu | En az 30 saniye arayla, işlem başına en çok 5 kez |
Transfer ve döviz kuralları
| Kural | Değer |
|---|---|
| Transfer para birimi | Bugün yalnız TRY |
| Alıcı adı | 2–140 karakter |
| Açıklama | En çok 140 karakter |
Idempotency-Key | 8–200 yazdırılabilir ASCII karakter |
| Tutar | Sıfırdan büyük tam sayı, minor birimde. Tek işlem tutarı sınırını banka belirler. |
| Bakiye | Lunixi kontrol etmez; banka karar verir. |
| Panelde onay bekleyen transfer | 10 dakika içinde kod onaylanmazsa iptal edilir. |
| Panel döviz oturumu | Kod onaylandıktan sonra 5 dakika; uzatılmaz. |
| Döviz teklifi | Bankanın belirlediği kısa süre (expiresAt, validForSeconds); çoğunlukla bir iki dakika. |
| API anahtarı IP izin listesi | Tek tek IP adresleri, en çok 50; aralık (CIDR) kabul edilmez. |
Hareket sorguları
| Sınır | Değer |
|---|---|
bookedFrom–bookedTo aralığı | Tek istekte en çok 92 gün |
| Tarih süzgeci olmadan | Sınır yok; bütün hareketler sayfalanır |
accountId süzgecindeki hesap sayısı | En çok 100 |
Daha uzun bir dönemi okumak için dönemi 92 günlük parçalara bölün ya da tarih süzgeci olmadan sayfalayın. → Hareketler
Saklama
Okunan hareketler süresiz saklanır; geçmiş hareketlere istediğiniz zaman API ve panel üzerinden erişebilirsiniz.
Sayfa boyutu
| Parametre | Değer |
|---|---|
limit | 1–100, varsayılan 25. 100'ün üstü 400 döner. |
pageInfo.totalCount | Bu uçlarda her zaman null. |
Çok kayıt okuyacaksanız limit=100 kullanın; aynı veri için dört kat daha az istek gönderirsiniz.