Hızlı başlangıç

API anahtarı oluşturun

Firma yöneticisi hesabıyla app.banka.pro üzerinde API anahtarları → Yeni anahtar adımlarını izleyin.

Tanım: Anahtarı tanımanızı sağlayan ad (ör. “Muhasebe entegrasyonu”).
Erişim bitişi: Anahtarın geçerli olduğu son gün.
IP kısıtı: İsteğe bağlı. Doluysa yalnız bu adreslerden gelen istekler kabul edilir.
Yetkiler: Entegrasyonun ihtiyaç duyduğu en dar yetki kümesi. Ayrıntılar için Kimlik doğrulama.

Kaydettiğinizde Anahtar kimliği (kullanıcı adı) ve Secret key (parola) gösterilir.

Secret key yalnız bu ekranda bir kez gösterilir. Hemen bir parola kasasına ya da sunucunuzun gizli değişkenlerine kaydedin. Kaybederseniz aynı sayfadan yenileyebilirsiniz; eski secret key o anda geçersiz olur.

İlk isteği gönderin

Anahtar kimliği kullanıcı adı, secret key parola olarak HTTP Basic ile gönderilir. Aşağıdaki istek firmanın banka hesaplarını listeler (Hesaplar yetkisi gerekir).

curl https://api.banka.pro/v1/bank-accounts \
  -u "$BANKAPRO_API_KEY_ID:$BANKAPRO_API_SECRET"

import os
import requests

response = requests.get(
    "https://api.banka.pro/v1/bank-accounts",
    auth=(os.environ["BANKAPRO_API_KEY_ID"], os.environ["BANKAPRO_API_SECRET"]),
    timeout=30,
)
response.raise_for_status()
accounts = response.json()["data"]

const credentials = Buffer.from(
  `${process.env.BANKAPRO_API_KEY_ID}:${process.env.BANKAPRO_API_SECRET}`,
).toString("base64");

const response = await fetch("https://api.banka.pro/v1/bank-accounts", {
  headers: { Authorization: `Basic ${credentials}` },
});
const { data: accounts } = await response.json();

<?php
$ch = curl_init('https://api.banka.pro/v1/bank-accounts');
curl_setopt_array($ch, [
    CURLOPT_USERPWD => getenv('BANKAPRO_API_KEY_ID') . ':' . getenv('BANKAPRO_API_SECRET'),
    CURLOPT_RETURNTRANSFER => true,
]);
$body = json_decode(curl_exec($ch), true);
$accounts = $body['data'];

Yanıtı okuyun

Başarılı yanıtlar her zaman success, data ve meta alanlarını taşır. Liste uçlarında meta sayfalama bilgisini de içerir.

200 OK

{
  "success": true,
  "data": [
    {
      "id": "64f000000000000000000101",
      "name": "Merkez TRY Hesabı",
      "bankName": "Örnek Banka",
      "bankCode": "00010",
      "iban": "TR000000000000000000000000",
      "currency": "TRY",
      "balance": "125000.50",
      "balanceKnown": true
    }
  ],
  "meta": {
    "requestId": "9cc0d3d1-1e63-4c90-b08f-90b6332e70ca",
    "timestamp": "2026-09-08T20:00:00.000Z",
    "page": 1,
    "pageSize": 25,
    "total": 1,
    "totalPages": 1
  }
}

Örnek kısaltılmıştır; bütün alanlar API referansında yer alır. Tutarların neden metin olduğunu ve balance: null değerinin anlamını Veri kuralları sayfası açıklar.

Sonraki adımlar

Yanıtlar ve hatalar

Hata zarfı, hata kodları ve x-request-id.

Artımlı eşitleme

Hareketleri sisteminize kayıpsız ve tekrar etmeden aktarın.

Başlarken

Temel kavramlar

Sonraki adımlar

Yanıtlar ve hatalar

Artımlı eşitleme

​Sonraki adımlar

Yanıtlar ve hatalar

Artımlı eşitleme

Sonraki adımlar