curl --request POST \
--url https://api.banka.pro/v1/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"
}Manuel banka sorgusu başlatı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.
curl --request POST \
--url https://api.banka.pro/v1/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
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 anahtardan sunucu tarafında belirlenir; istemciden firma kimliği alınmaz. 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
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.
1 - 100^[A-Za-z0-9._:-]{1,100}$Gövde
- Option 1
- Option 2
Show child attributes
Show child attributes
Yanıt
Sorgu sonuç sayaçları
true Show child attributes
Show child attributes
Show child attributes
Show child attributes
{
"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"
}