Türkiye formları için yapısal kontrol ve standartlaştırma API'si
IBAN yapı kontrolü, telefon formatlama, TCKN/VKN yapısal kontrolü ve il/ilçe eşleme işlemlerini tek API ile yönetin.
TR Validation API, geliştiricilerin kendi formlarında aldığı Türkiye'ye özel verileri anlık olarak yapısal kontrolden geçirmek ve standart formata çevirmek için tasarlanmıştır.
Sinirlar ve veri notu
- Istek sirasinda yapay zeka modeli cagirmadan calisir.
- Sadece regex bakmaz; kontrol basamagi hesaplar, veriyi duzenler ve yardimci kayitlarla eslestirir.
- Resmi kişi, şirket veya banka hesabı sorgusu yapmaz.
- Kişisel veri veritabanı sunmaz.
- Kalıcı bir kişi veritabanı oluşturmak için değil, anlık yapısal kontrol için tasarlanmıştır.
Veri isleme ve kullanim sinirlari icin gizlilik ve kullanim sartlarini inceleyin. Gizlilik • Kullanim sartlari
Pro
Planlar
Pazaryeri karar yüzeyidir; abonelik ve API anahtarı oluşturma portalda tamamlanır.
Starter
- Aylık kota
- 25.000
- Dakika limiti
- 60 rpm
Pro
- Aylık kota
- 150.000
- Dakika limiti
- 180 rpm
Business
- Aylık kota
- 1.000.000
- Dakika limiti
- 600 rpm
Ayni cekirdegi hosted API ile veya local npm paketiyle kullanin
Core validation engine acik kaynak `@apideposu/tr-validation` paketi olarak da sunulur. Hosted API, ayni cekirdegin API anahtari, kota, usage, plan ve portal katmaniyla paketlenmis halidir.
Hosted API
- API anahtari, plan, kota ve rate limit gerekir.
- Portal, Test Lab ve usage kayitlari ile gelir.
- Takimlar, dashboard ve yonetilen erisim akislari icin uygundur.
Local npm paketi
- TypeScript projesi icinde tamamen local calisir.
- Network call, telemetry veya backend baglantisi yoktur.
- Kendi uygulamasinda validation ve normalization yapmak isteyen ekipler icin uygundur.
- Paket local-only calisir ve API Deposu backend'ine istek atmaz.
- Hosted API ile npm paketi ayni urun kontrati degil; ama cekirdek validation mantigi ayni yonde tutulur.
- Iki yuzey de resmi kisi, sirket, vergi veya banka hesabi dogrulamasi yapmaz.
Kimler için
- Form toplayan web uygulamaları ve iç araçlar
- E-ticaret, teslimat ve kayıt ekranları
- Ön başvuru, üyelik ve onboard akışları
- Ajanslar, otomasyon kuran ekipler ve no-code araçları
Kapsam
- IBAN yapı kontrolü ve kurum kodu eşleme
- Türkiye telefon numarası formatlama ve tip ayrımı
- TCKN ve VKN için yapısal kontrol
- İl, ilçe, plaka ve alan kodu eşleme
- Türkçe metin ve serbest adres girişini düzenleme
- Tek istekte 25 kayda kadar toplu kontrol
Endpoint'ler
Temel kontroller
POST /iban/validatePOST /phone/normalizePOST /id/validatePOST /bulk/validateYardımcı veriler
GET /locations/provincesGET /locations/districtsGET /locations/resolvePOST /text/normalizePOST /address/normalizeBu API'nin yapmadıkları
Yanlış beklentiyle başlamayın: Bu API aşağıdaki işlemleri yapmaz. Bu işlemler için resmi entegrasyonlar gerekir.
- Resmi kişi, şirket veya vatandaşlık sorgusu
- Banka hesabının gerçekten var olduğunu veya kime ait olduğunu kanıtlama
- Kişi veritabanı, toplu kişi kaydı veya resmi profil sorgusu
- Güncel operatör ya da numara taşıma sorgusu
- UAVT, adres kodu veya resmi adres kayıtları