Hızlı başlangıç
- 1Pazaryeri'nde ürünü açın ve ücretsiz planı aktive edin.
- 2Plaintext API anahtarınızı kopyalayın — yalnızca bir kez gösterilir.
- 3İstek atarken X-ApiDeposu-Key header'ı veya Authorization: Bearer ile gönderin.
- 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
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"}'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();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
/v1/tr-validation/iban/validateIBAN format ve checksum doğrula
/v1/tr-validation/phone/normalizeTelefon numarası normalize et
/v1/tr-validation/id/validateTCKN/VKN format ve checksum
/v1/tr-validation/locations/provincesİl listesi
/v1/tr-validation/locations/districtsBir il için ilçe listesi
/v1/tr-validation/locations/resolveSerbest metinden il/ilçe çöz
/v1/tr-validation/text/normalizeTürkçe metni normalize et
/v1/tr-validation/address/normalizeTürkçe adresi normalize et
/v1/tr-validation/bulk/validate25 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.
Body veya query doğrulama hatası — örn. IBAN alanı zorunlu.
API anahtarı eksik, geçersiz, iptal edilmiş veya süresi dolmuş.
Anahtar başka bir ürüne ait, ürün/abonelik aktif değil veya periyot kapanmış.
Dakikalık rate limit veya aylık kota aşıldı. Header'lara bakıp bekleyin.
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.