API Dokümantasyonu

Tek bir POST isteğiyle her ülkeden PDF banka ekstresini yapılandırılmış JSON, CSV veya XLSX'e çevirin. Bilinmeyen formatlar otomatik öğrenilir, taranmış PDF'lerde OCR var, sonuçlar bakiye zinciriyle doğrulanır. Aylık 50 sayfa ücretsiz.

Hızlı Başlangıç

1. Ücretsiz hesap oluşturun ve API anahtarınızı alın.

Ücretsiz Başla

Kimlik Doğrulama

Her istekte aşağıdaki yöntemlerden birini kullanın:

Bearer JWT

Authorization: Bearer <your_jwt_token>

API Key

X-Api-Key: pex_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

PDF Çıkarma

POST/extract

PDF yükleyin, işlem listesini JSON veya CSV olarak alın. Dosya yükleme veya URL ile çalışır.

Form Alanları

Alan	Tür	Açıklama
file	File	PDF dosyası (max 20 MB)
url	string	PDF URL'si (file yerine)
webhookUrl	string	İşlem tamamlandığında çağrılacak URL
format	string	Çıktı formatı: json (varsayılan), csv veya xlsx

cURL Örneği

curl -X POST https://api.bankstatementparser.net/extract \
  -H "X-Api-Key: pex_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -F "file=@statement.pdf"

200Başarılı — bilinen format

{
  "requestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "bankKey": "bank_v1",
  "pageCount": 2,
  "transactionCount": 45,
  "transactions": [
    {
      "date": "2024-01-15",
      "valueDate": "2024-01-15",
      "description": "MARKET PAYMENT",
      "processNo": "TRN000123456",
      "amount": -250.00,
      "balance": 4750.00
    }
  ]
}

202Kuyruğa alındı — bilinmeyen format

{
  "queueId": "a1b2c3d4-...",
  "status": "queued",
  "message": "Unknown PDF format. Queued for profile generation."
}

Hak İadesi (Hatalı PDF Bildirimi)

PDF hatalı işlendiyse 14 gün içinde bildirebilirsiniz. Onaylanırsa kullanılan sayfa hakkınız iade edilir.

POST/api/refund/requestYeni bildirim — JWT gerekli

// Request body
{
  "usageLogId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  // requestId from /extract
  "reason": "Got 8 transactions instead of 15, page 2 was skipped"
}

// 200 OK
{ "message": "Bildiriminiz alındı." }

GET/api/refund/my-requestsKendi bildirimlerim

[
  {
    "id": "...",
    "usageLogId": "3fa85f64-...",
    "reason": "...",
    "pageCount": 3,
    "status": "Pending",  // Pending | Approved | Rejected
    "adminNote": null,
    "createdAt": "2026-06-26T10:00:00Z"
  }
]

Rate Limit

Kural	Limit
Demo (API anahtarsız) — günlük IP başına	5 istek/gün
/api/auth/*	5 istek/dakika
/extract	20 istek/dakika
Diğer endpoint'ler	100 istek/dakika