curl --request POST \
  --url https://api.banka.pro/v1/companies/{companyId}/bank-queries \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "scope": "account",
    "accountId": "64f000000000000000000101"
  }
}
'

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

{
  "success": false,
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "pageSize 1-100 araliginda olmalidir.",
    "details": [
      {
        "field": "pageSize",
        "rule": "min:1,max:100"
      }
    ]
  },
  "traceId": "9cc0d3d1-1e63-4c90-b08f-90b6332e70ca"
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "İstek doğrulanamadı.",
    "details": [
      {
        "field": "pageSize",
        "rule": "min:1,max:100"
      }
    ]
  },
  "traceId": "9cc0d3d1-1e63-4c90-b08f-90b6332e70ca"
}

{
  "success": false,
  "error": {
    "code": "FORBIDDEN",
    "message": "Bu islem icin yetkiniz bulunmuyor.",
    "details": []
  },
  "traceId": "9cc0d3d1-1e63-4c90-b08f-90b6332e70ca"
}

{
  "success": false,
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Banka hareketi bulunamadi.",
    "details": []
  },
  "traceId": "9cc0d3d1-1e63-4c90-b08f-90b6332e70ca"
}

{
  "success": false,
  "error": {
    "code": "PAYLOAD_TOO_LARGE",
    "message": "Istek govdesi izin verilen boyutu asiyor.",
    "details": []
  },
  "traceId": "9cc0d3d1-1e63-4c90-b08f-90b6332e70ca"
}

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Istek limiti asildi. Daha sonra tekrar deneyin.",
    "details": []
  },
  "traceId": "9cc0d3d1-1e63-4c90-b08f-90b6332e70ca"
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "İstek doğrulanamadı.",
    "details": [
      {
        "field": "pageSize",
        "rule": "min:1,max:100"
      }
    ]
  },
  "traceId": "9cc0d3d1-1e63-4c90-b08f-90b6332e70ca"
}

Entegratör: firma verisi

Manuel banka sorgusu başlatır (entegratör)

Entegratör anahtarıyla müşteri firmasının verisi; davranış firma anahtarındaki /v1/bank-queries ile aynıdır. Anahtarın bağlı olduğu firmanın banka hesaplarını bankadan hemen sorgular. Gövdedeki scope yetki veya firma seçimi değildir: account tek hesabı, current_company_all firmanın uygun bütün hesaplarını sırayla sorgular; yanıt sorgular bitince döner. Boş gövde bütün hesaplar anlamına gelmez. Aynı hesap için süren bir sorgu varsa o hesabın sonucu skipped olur; bütün hedefler skipped olsa da yanıt başarılıdır. İstek idempotent değildir; tekrarlanan istek önceki sonucu döndürmeyi garanti etmez. Anahtar başına dakikada en fazla 6 istek kabul edilir.

POST

companies

{companyId}

bank-queries

curl --request POST \
  --url https://api.banka.pro/v1/companies/{companyId}/bank-queries \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "scope": "account",
    "accountId": "64f000000000000000000101"
  }
}
'

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

{
  "success": false,
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "pageSize 1-100 araliginda olmalidir.",
    "details": [
      {
        "field": "pageSize",
        "rule": "min:1,max:100"
      }
    ]
  },
  "traceId": "9cc0d3d1-1e63-4c90-b08f-90b6332e70ca"
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "İstek doğrulanamadı.",
    "details": [
      {
        "field": "pageSize",
        "rule": "min:1,max:100"
      }
    ]
  },
  "traceId": "9cc0d3d1-1e63-4c90-b08f-90b6332e70ca"
}

{
  "success": false,
  "error": {
    "code": "FORBIDDEN",
    "message": "Bu islem icin yetkiniz bulunmuyor.",
    "details": []
  },
  "traceId": "9cc0d3d1-1e63-4c90-b08f-90b6332e70ca"
}

{
  "success": false,
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Banka hareketi bulunamadi.",
    "details": []
  },
  "traceId": "9cc0d3d1-1e63-4c90-b08f-90b6332e70ca"
}

{
  "success": false,
  "error": {
    "code": "PAYLOAD_TOO_LARGE",
    "message": "Istek govdesi izin verilen boyutu asiyor.",
    "details": []
  },
  "traceId": "9cc0d3d1-1e63-4c90-b08f-90b6332e70ca"
}

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Istek limiti asildi. Daha sonra tekrar deneyin.",
    "details": []
  },
  "traceId": "9cc0d3d1-1e63-4c90-b08f-90b6332e70ca"
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "İstek doğrulanamadı.",
    "details": [
      {
        "field": "pageSize",
        "rule": "min:1,max:100"
      }
    ]
  },
  "traceId": "9cc0d3d1-1e63-4c90-b08f-90b6332e70ca"
}

Yetkilendirmeler

Authorization

string

header

gerekli

Kullanıcı adı anahtar kimliği, parola secret key değeridir. Anahtar aktif olmalı, erişim bitiş tarihi geçmemiş olmalı ve BankaPro erişimine sahip olmalıdır. Firma anahtarında firma anahtardan sunucu tarafında belirlenir; istemciden firma kimliği alınmaz. Entegratör anahtarı firmayı yalnız /v1/companies/{companyId} adresinden alır ve yalnız kendi müşteri firmalarına erişir. Anahtarın IP kısıtı doluysa istek yalnız listedeki adreslerden kabul edilir. Kimlik bilgileri yalnız HTTPS üzerinden gönderilmelidir.

Başlıklar

x-request-id

string

Opsiyonel izleme kimliği. Değer 1-100 karakter ve yalnız harf, rakam, nokta, alt çizgi, iki nokta veya tire içeriyorsa korunur; aksi halde sunucu yeni bir UUID üretir.

Required string length: 1 - 100

Pattern: ^[A-Za-z0-9._:-]{1,100}$

Yol Parametreleri

companyId

string

gerekli

Müşteri firmasının kimliği (POST /v1/companies yanıtındaki id). Firma bu entegratöre ait değilse 404, pasifse 403 COMPANY_PASSIVE döner.

Pattern: ^[a-fA-F0-9]{24}$

Örnek:

"64f000000000000000000001"

Gövde

application/json

data

object

gerekli

Option 1
Option 2

Show child attributes

Yanıt

Sorgu sonuç sayaçları

success

enum<boolean>

gerekli

Mevcut seçenekler:

true

Banka hesapları

Banka hareketleri

Banka sorgusu

Entegratör: firmalar ve kredi

Entegratör: banka bağlantıları

Entegratör: firma verisi

Manuel banka sorgusu başlatır (entegratör)

Yetkilendirmeler

Başlıklar

Yol Parametreleri

Gövde

Yanıt