Geliştiriciler İçin Banka Ekstresi API Rehberi — 2026

Geliştiriciler İçin Banka Ekstresi API Rehberi

Fintech uygulamanıza, muhasebe yazılımınıza veya veri pipeline'ınıza banka ekstresi işleme entegre etmek istiyorsanız bu rehber tam size göre.

Kimlik Doğrulama

API anahtarınızı panelden oluşturun (pex_ ile başlar):

curl -X POST https://api.bank-statement-parser.clkr.work/extract \
  -H "X-Api-Key: pex_your_key" \
  -F "file=@ekstre.pdf"

Python

import requests

class BankStatementParser:
    BASE_URL = "https://api.bank-statement-parser.clkr.work"

    def __init__(self, api_key: str):
        self.headers = {"X-Api-Key": api_key}

    def extract(self, pdf_path: str) -> dict:
        with open(pdf_path, "rb") as f:
            resp = requests.post(
                f"{self.BASE_URL}/extract",
                headers=self.headers,
                files={"file": f}
            )
        resp.raise_for_status()
        return resp.json()

parser = BankStatementParser("pex_your_key")
result = parser.extract("ekstre.pdf")
print(f"{result['bankKey']}: {len(result['transactions'])} işlem")

Node.js

import FormData from 'form-data';
import fs from 'fs';
import fetch from 'node-fetch';

async function parseStatement(filePath) {
  const form = new FormData();
  form.append('file', fs.createReadStream(filePath));

  const response = await fetch(
    'https://api.bank-statement-parser.clkr.work/extract',
    {
      method: 'POST',
      headers: { 'X-Api-Key': 'pex_your_key', ...form.getHeaders() },
      body: form,
    }
  );
  return response.json();
}

const result = await parseStatement('ekstre.pdf');
console.log(${result.bankKey}: ${result.transactions.length} işlem);

Hata Yönetimi

import requests
from requests.exceptions import RequestException

def safe_extract(pdf_path: str, api_key: str) -> dict | None:
    try:
        resp = requests.post(
            "https://api.bank-statement-parser.clkr.work/extract",
            headers={"X-Api-Key": api_key},
            files={"file": open(pdf_path, "rb")},
            timeout=60
        )
        if resp.status_code == 402:
            print("Kota doldu — planı yükseltin")
            return None
        if resp.status_code == 422:
            print("Format desteklenmiyor veya OCR gerekiyor")
            return None
        resp.raise_for_status()
        return resp.json()
    except RequestException as e:
        print(f"Bağlantı hatası: {e}")
        return None

Ücretsiz Başlayın

[API Anahtarı Al →](https://bank-statement-parser.clkr.work/tr/kayit)