IBAN API

Geliştiriciler için ücretsiz ve limitli bir IBAN doğrulama API'si. Tüm uç noktalar JSON döner ve CORS'a açıktır. İstekler oran sınırına (rate limit) tabidir.

API yalnızca biçimsel doğrulama yapar. Hesap varlığı, sahipliği veya aktifliği hakkında bilgi döndürmez. Loglarda ham IBAN tutulmaması hedeflenir.

POST /api/validate

Tek bir IBAN'ı doğrular.

İstek (curl)

curl -X POST https://ibanaraci.com/api/validate \
  -H "Content-Type: application/json" \
  -d '{ "iban": "TR330006100519786457841326" }'

Yanıt (JSON)

{
  "valid": true,
  "normalized": "TR330006100519786457841326",
  "formatted": "TR33 0006 1005 1978 6457 8413 26",
  "countryCode": "TR",
  "countryName": "Türkiye",
  "checkDigits": "33",
  "bankCode": "00061",
  "bankName": "...",
  "errors": [],
  "message": "IBAN biçimsel olarak geçerlidir. Hesap varlığı doğrulanmamıştır."
}

POST /api/bulk-validate

Bir dizi IBAN'ı toplu doğrular (en fazla 1000 adet, daha düşük oran sınırı).

İstek

POST /api/bulk-validate
{
  "ibans": ["TR33...", "DE89...", "bozuk"]
}

GET /api/bank-code/{country}/{code}

Türkiye banka kodunu banka bilgisine çevirir.

İstek

GET /api/bank-code/TR/00062

Oran sınırları

/api/validate: dakikada 60 istek
/api/bulk-validate: dakikada 20 istek
/api/bank-code: dakikada 120 istek

Sınır aşıldığında 429 yanıtı ve Retry-After başlığı döner. Daha yüksek limit veya kurumsal kullanım için iletişime geçebilirsiniz.

Kod örnekleri

Kendi projenizde IBAN doğrulaması yapmak için hazır JavaScript/TypeScript örneklerine JavaScript IBAN kodu sayfasından ulaşabilirsiniz.