Artımlı eşitleme

BankaPro banka hesaplarınızı düzenli olarak kendisi sorgular. API’de webhook veya canlı bağlantı yoktur; güncel veriyi REST istekleriyle çekersiniz. Önerilen akış:

İlk aktarım

Başlangıç tarihinden itibaren bütün hareketleri sayfa sayfa çekin ve hareket id değeriyle sisteminize kaydedin.

curl "https://api.banka.pro/v1/bank-transactions?startDate=2026-01-01&pageSize=100&page=1" \
  -u "$BANKAPRO_API_KEY_ID:$BANKAPRO_API_SECRET"

İstekten önce o anki UTC zamanı bir eşitleme imleci olarak saklayın.

Değişiklikleri çekin

Sonraki çalışmalarda updatedSince ile yalnız son imleçten sonra eklenen veya güncellenen hareketleri isteyin. Durum ve not değişiklikleri de bu sorguyla gelir.

curl "https://api.banka.pro/v1/bank-transactions?updatedSince=2026-09-08T19:55:00Z&pageSize=100" \
  -u "$BANKAPRO_API_KEY_ID:$BANKAPRO_API_SECRET"

Kimliğe göre güncelleyin

Gelen her hareketi id ile ekle ya da güncelle (upsert) mantığıyla yazın. Böylece aynı hareketin iki kez gelmesi sorun yaratmaz.

İmleci birkaç dakika geriden başlatın (ör. son imleç − 5 dakika). Sınırdaki güncellemeleri kaçırmazsınız; tekrar gelen kayıtları upsert zaten tekilleştirir.

Liste updatedAt’e göre değil, hareket tarihine göre sıralanır. Sayfaları gezerken yeni bir güncelleme gelirse bir kaydı iki kez görebilirsiniz; bu da kimliğe göre upsert ile çözülür.

Bankayı hemen sorgulatma

Düzenli sorguyu beklemeden güncel veri gerekiyorsa POST /v1/bank-queries ile manuel sorgu başlatın. Anahtarda Banka sorgusu (baSync) yetkisi gerekir.

curl -X POST https://api.banka.pro/v1/bank-queries \
  -u "$BANKAPRO_API_KEY_ID:$BANKAPRO_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"data":{"scope":"account","accountId":"64f000000000000000000101"}}'

curl -X POST https://api.banka.pro/v1/bank-queries \
  -u "$BANKAPRO_API_KEY_ID:$BANKAPRO_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"data":{"scope":"current_company_all"}}'

Gövde zorunludur; boş gövde “bütün hesaplar” anlamına gelmez.
current_company_all firmanın uygun hesaplarını sırayla sorgular; yanıt sorgular bitince döner. İstemci zaman aşımınızı buna göre ayarlayın.
Aynı hesap için zaten süren bir sorgu varsa o hesabın sonucu skipped olur. Bütün hesaplar skipped olsa bile yanıt başarılıdır.
Anahtar başına dakikada en çok 6 sorgu isteği kabul edilir.

200 OK

{
  "success": true,
  "data": {
    "total": 2,
    "triggered": 1,
    "succeeded": 1,
    "failed": 0,
    "skipped": 1,
    "results": [
      { "accountId": "64f000000000000000000101", "status": "success" },
      { "accountId": "64f000000000000000000102", "status": "skipped" }
    ],
    "ranAt": "2026-09-08T20:00:00.000Z"
  },
  "meta": { "requestId": "9cc0d3d1-1e63-4c90-b08f-90b6332e70ca", "timestamp": "2026-09-08T20:00:05.000Z" }
}

Sorgu yanıtı hareket taşımaz. Sonuçları almak için ardından updatedSince ile hareketleri çekin.

Başlarken

Temel kavramlar

Bankayı hemen sorgulatma

​Bankayı hemen sorgulatma

Bankayı hemen sorgulatma