API Deposu
PazaryeriKataloğa gitBlogMCPTest LabAPI EkleDestek OlGitHub
Dokümantasyon listesine dön
Dokümantasyon
https://api.apideposu.com

Turkiye Form Yapisal Kontrol API

IBAN yapi kontrolu, telefon formatlama, TCKN/VKN yapisal kontrolu, il/ilce esleme, metin/adres duzenleme ve toplu kontrol sunar. Istek sirasinda yapay zeka modeli cagirmaz. Sadece regex bakmaz; kontrol basamagi hesaplar ve veriyi standart hale getirir. Resmi kimlik, sirket veya hesap sahipligi sorgulamaz.

OpenAPI ReferansıTest Lab'i açPazaryeri'nde aç

Hızlı başlangıç

  1. 1Pazaryeri'nde ürünü açın ve ücretsiz planı aktive edin.
  2. 2Plaintext API anahtarınızı kopyalayın — yalnızca bir kez gösterilir.
  3. 3İstek atarken X-ApiDeposu-Key header'ı veya Authorization: Bearer ile gönderin.
  4. 4Test Lab veya curl ile ilk çağrınızı doğrulayın.

Kimlik doğrulama

Pazaryeri ürün sayfasından ücretsiz planı aktive edin. Anahtarınız bir kez gösterilir; güvenli bir yere kaydedin.

Base URL
https://api.apideposu.com
Auth header
X-ApiDeposu-Key: <token>

Örnek istek

bash
curl
curl -X POST https://api.apideposu.com/v1/tr-validation/iban/validate \
  -H "X-ApiDeposu-Key: apd_live_..." \
  -H "Content-Type: application/json" \
  -d '{"iban":"TR33 0006 1005 1978 6457 8413 26"}'
javascript
fetch
const res = await fetch(
  "https://api.apideposu.com/v1/tr-validation/iban/validate",
  {
    method: "POST",
    headers: {
      "X-ApiDeposu-Key": process.env.APIDEPOSU_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ iban: "TR33 0006 1005 1978 6457 8413 26" }),
  },
);
const data = await res.json();
python
requests
import os, requests

resp = requests.post(
    "https://api.apideposu.com/v1/tr-validation/iban/validate",
    headers={
        "X-ApiDeposu-Key": os.environ["APIDEPOSU_KEY"],
        "Content-Type": "application/json",
    },
    json={"iban": "TR33 0006 1005 1978 6457 8413 26"},
    timeout=10,
)
resp.raise_for_status()
data = resp.json()

Endpoint'ler

POST
/v1/tr-validation/iban/validate

IBAN format ve checksum doğrula

POST
/v1/tr-validation/phone/normalize

Telefon numarası normalize et

POST
/v1/tr-validation/id/validate

TCKN/VKN format ve checksum

GET
/v1/tr-validation/locations/provinces

İl listesi

GET
/v1/tr-validation/locations/districts

Bir il için ilçe listesi

GET
/v1/tr-validation/locations/resolve

Serbest metinden il/ilçe çöz

POST
/v1/tr-validation/text/normalize

Türkçe metni normalize et

POST
/v1/tr-validation/address/normalize

Türkçe adresi normalize et

POST
/v1/tr-validation/bulk/validate

25 itemlık toplu doğrulama

Hata kodları

Gateway, kullanıcı isteğini doğrulayamadığında veya ürün koşulları sağlanmadığında aşağıdaki HTTP kodlarıyla cevap verir.

400

Body veya query doğrulama hatası — örn. IBAN alanı zorunlu.

401

API anahtarı eksik, geçersiz, iptal edilmiş veya süresi dolmuş.

403

Anahtar başka bir ürüne ait, ürün/abonelik aktif değil veya periyot kapanmış.

429

Dakikalık rate limit veya aylık kota aşıldı. Header'lara bakıp bekleyin.

500

Geçici sunucu hatası. Tekrar deneyin; sorun devam ederse bildirin.

Rate limit

Her istekte X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset header'ları döner. Limit aşılırsa 429 alırsınız ve sonraki dakika başında yeniden başlar.

Aylık kota

Aylık kotanız periyot başında sıfırlanır. Yanıt header'ları X-Quota-Limit ve X-Quota-Remaining kalan hakkınızı gösterir.

Bu API ne yapar

  • Istek sirasinda yapay zeka modeli cagirmadan calisir
  • Sadece regex degil; kontrol basamagi, duzenleme ve esleme birlikte yapar
  • IBAN yapı kontrolü ve MOD-97 checksum
  • Türk telefon numarası formatlama (E.164 + ulusal format)
  • TCKN ve VKN yapısal kontrolü
  • 81 il ve ilçeleri için statik eşleme
  • Türkçe metin ve adres metni normalizasyonu
  • 25 item'a kadar bulk validation

Bu API ne yapmaz

  • Resmi kişi/kurum kimlik kaydı sorgulama (Nüfus, MERSIS yok)
  • IBAN hesap sahipliği veya hesap varlığı kontrolü
  • Kişisel veri veritabanı veya toplu kişi kaydı
  • Telefon operatörü canlı sorgusu / numara taşıma kaydı
  • UAVT veya resmi adres kodu eşleştirmesi