Sayfalama ve filtreler

Sayfalama

Liste uçları page ve pageSize parametrelerini kabul eder.

Uç	Varsayılan `pageSize`	En çok
`GET /v1/bank-transactions`	25	100
`GET /v1/bank-accounts`	25	500
`GET /v1/bank-accounts/{id}/balance-history`	25	500

page 1’den başlar. Yanıtın meta alanı toplam kayıt ve sayfa sayısını verir:

"meta": { "page": 2, "pageSize": 100, "total": 1340, "totalPages": 14 }

Bütün sayfaları gezmek için page değerini totalPages’e ulaşana kadar artırın.

Sıralama

Hareketler her zaman en yeniden eskiye döner: önce transactionDate, eşitlikte hareket kimliği azalan sırada. Sıralama parametresi yoktur.

Filtreler

Filtreler doğrudan sorgu parametresi olarak ya da filter[...] biçiminde gönderilebilir; iki yazım aynı sonucu verir.

# İkisi de aynı
curl "https://api.banka.pro/v1/bank-transactions?currency=USD&direction=incoming" -u "$KEY:$SECRET"
curl "https://api.banka.pro/v1/bank-transactions?filter[currency]=USD&filter[direction]=incoming" -u "$KEY:$SECRET"

Hareket filtreleri

Parametre	Açıklama
`accountId`	Tek banka hesabının hareketleri
`currency`	Para birimi (`TRY` filtresi para birimi boş kayıtları da kapsar)
`bankCode`	Banka kodu
`direction`	`incoming` veya `outgoing`
`incoming`	`direction` filtresinin `true`/`false` karşılığı; ikisi birlikte gönderilirse aynı yönü göstermelidir
`status`	`0` bekliyor, `1` işlendi, `2` yok sayıldı
`startDate`, `endDate`	Hareket tarihi aralığı, sınırlar dahil. Bkz. Zaman
`updatedSince`	Bu andan sonra güncellenen hareketler. Bkz. Artımlı eşitleme
`q`	Metin araması (aşağıda)

GET /v1/bank-transactions/summary sayfalama dışında aynı filtreleri kabul eder ve gelen, giden ve net tutarı para birimi bazında döner.

Hesap filtreleri

Parametre	Açıklama
`currency`	Para birimi
`bankCode`	Banka kodu
`archived`	`true` arşivlenmiş hesapları getirir; gönderilmezse arşivlenmemiş hesaplar listelenir
`isApi`	Hesabın `isApi` değerine göre süzer (`true` / `false`)
`q`	Metin araması (aşağıda)

Arama (`q`)

q 2–100 karakterdir; büyük/küçük harf ve Türkçe karakter farkını gözetmez.

Hesaplarda hesap adı, banka adı ve kodu, hesap kodu ve IBAN aranır.
Hareketlerde karşı taraf adında ve açıklamanın kelimelerinde aranır. Açıklamada en az 3 harfli kelimeler eşleşir.
Anahtarda Kişisel veriler (baPii) yetkisi varsa karşı taraf IBAN’ı ve TCKN/VKN’si de aranır. IBAN veya 10–11 haneli kimlik numarası niteliğindeki bir arama bu yetki yoksa 403 FORBIDDEN döner.

Başlarken

Temel kavramlar

Sayfalama

Sıralama

Filtreler

Hareket filtreleri

Hesap filtreleri

Arama (`q`)

​Sayfalama

​Sıralama

​Filtreler

​Hareket filtreleri

​Hesap filtreleri

​Arama (q)

Sayfalama

Sıralama

Filtreler

Hareket filtreleri

Hesap filtreleri

Arama (`q`)