Question 1

NADAS Kurumsal API nedir?

Accepted Answer

Kurumsal API, 480 milyondan fazla kayıtlık gayrimenkul verisine REST + WebSocket erişim sunar. Endeks, 38 boyutlu mahalle DNA'sı, olay markırı, güven skoru ve ProX karar analizi uçlarını kapsar; tenant anahtarı ile kimlik doğrulaması ve %99.99 SLA ile çalışır.

Question 2

API hangi verilere ve uçlara erişim veriyor?

Accepted Answer

Endpoint kataloğu; il/ilçe/mahalle bazında ₺/m², skor, delta ve trend endeksi (257 aylık zaman serisi), 38 boyutlu mahalle DNA'sı, 7M+ olay markırı, güven skoru sorgusu ve ProX karar analizi/PDF üretimini içerir. Yanıtlar JSON, taşıma TLS 1.3'tür.

Question 3

API'yi kimler kullanır?

Accepted Answer

Banka, sigorta, fon, belediye ve proptech firmaları kurumsal API kullanır. Teminat değerleme, risk skorlaması, portföy izleme, imar/rayiç takibi ve scoring motoru gibi senaryolarda NADAS veritabanına doğrudan bağlanırlar.

Question 4

REST ve WebSocket farkı nedir; canlı veri nasıl akar?

Accepted Answer

REST uçları tekil sorgu ve toplu erişim içindir. Endeks güncellemeleri ise /stream WebSocket ucundan anlık iletilir; polling yerine push kullanılır, yeniden bağlanma ve son-durum senkronizasyonu desteklenir.

Question 5

API kimlik doğrulaması nasıl yapılıyor?

Accepted Answer

Her istek X-Tenant-Id ve X-Tenant-Key başlıklarıyla imzalanır. Anahtar kuruma özeldir ve sunucu tarafında Origin/Referer allowlist, IP kısıtı ve kapsam (scope) ile sınırlandırılır; böylece anahtar sızsa bile yetkisiz kullanım engellenir.

Question 6

Rate limit (istek sınırı) nasıl çalışıyor?

Accepted Answer

İstek hızı üyelik tier'ına göre sınırlıdır. Sınır aşıldığında 429 yanıtı ve X-RateLimit-* başlıklarıyla kalan kota bildirilir. Toplu (batch) ve akış (stream) uçları ayrı kotalarda yönetilir.

Question 7

API güvenliği nasıl sağlanıyor?

Accepted Answer

Tüm trafik TLS 1.3 ile şifrelenir; düz-metin uç yoktur. CORS Origin allowlist ile yönetilir, yanıtlar imzalıdır ve hata gövdeleri iç ayrıntı sızdırmaz. Tüm çağrılar audit loglanır.

Question 8

SLA ve performans garantileri nelerdir?

Accepted Answer

Kurumsal anlaşmada aylık %99.99 erişilebilirlik taahhüdü ve 1 saat yanıt hedefi vardır; durum sayfası ve olay bildirimi kurumsal hesaba açıktır. Endeks ve referans uçlarında tipik p95 gecikme ~84ms'tir; ağır analiz (ProX/rapor) uçları asenkron çalışır ve iş kimliğiyle sonuç çekilir.

Question 9

API sürümleniyor mu; eski sürümler ne olur?

Accepted Answer

Evet. Uçlar /api/v1 ve /api/v2 altında sürümlenir. Kırıcı değişiklik yeni sürümle gelir; eski sürüm, duyurulu bir geçiş süresince yaşamaya devam eder, böylece entegrasyonunuz aniden bozulmaz.

Question 10

API erişimi veri mülkiyetini devrediyor mu?

Accepted Answer

Hayır. API erişimi veri mülkiyetini devretmez. Kapsam (il/ilçe/kategori), kullanım hakları ve yeniden dağıtım koşulları sözleşmeyle tanımlanır; veri kopyalanmaz, sorguyla erişilir.

Question 11

API verisi KVKK uyumlu mu?

Accepted Answer

Evet. Veri Türkiye'de barınır ve kişisel veri içermeyen toplu/anonim endeks verisi sunulur. Endeks aylık, akış anlık günceldir; her yanıt köken ve tazelik meta verisi taşır ve çıktılar deterministik ProX motorundan gelir (aynı girdi, aynı çıktı, halüsinasyon yok).

Question 12

Kurumsal API erişimini nasıl açtırırım?

Accepted Answer

Kurumsal API erişimi ProX Corporate üyeliğinde ve kurumsal anlaşmada açılır. Ayrı bir SDK gerekmez; standart HTTP çağrılarıyla (curl dâhil) kullanılır. Anahtar talebi ve tier seçimi için bilgi@emlakekspertizi.com adresinden başvurabilirsiniz.

Question 13

API'yi kullanmak için SDK gerekiyor mu?

Accepted Answer

Hayır. Ayrı bir SDK gerekmez; API standart HTTP çağrılarıyla, curl dâhil herhangi bir istemciyle kullanılır. Dokümantasyonda hazır kod örnekleri sunulur.

Question 14

Toplu (batch) ve akış (stream) erişimi ayrı mı yönetiliyor?

Accepted Answer

Evet. Toplu ve akış uçları ayrı kotalarda yönetilir. Akış (WebSocket /stream) anlık push sağlar; toplu uçlar ise büyük hacimli sorgular için tasarlanmıştır.

Question 15

Anahtarım sızarsa ne olur?

Accepted Answer

Anahtar tek başına yetmez: sunucu tarafında Origin/Referer allowlist, IP kısıtı ve kapsam (scope) uygulanır. İzin verilmeyen bir origin veya IP'den gelen istek reddedilir; tüm çağrılar audit loglanır.

Question 16

Endeks verisi ne kadar güncel akıyor?

Accepted Answer

Endeks aylık, akış ise anlık günceldir. /stream ucundan güncellemeler push ile iletilir ve her yanıt köken ile tazelik meta verisi taşır.

Question 17

ProX karar analizini API'den alabilir miyim?

Accepted Answer

Evet. ProX karar analizi ve PDF üretimi API uçları arasındadır. Bu ağır analiz uçları asenkron çalışır; isteği gönderir, dönen iş kimliğiyle sonucu çekersiniz.

Question 18

Hata durumunda ne tür yanıt alırım?

Accepted Answer

Kota aşımında 429 yanıtı ve kalan kotayı bildiren X-RateLimit-* başlıkları döner. Hata gövdeleri iç ayrıntı sızdırmaz; yanıtlar imzalıdır ve tüm trafik TLS 1.3 ile şifrelidir.

Question 19

API fiyatlandırması nasıl?

Accepted Answer

Sayısal SLA ve kota değerleri tier'a göre değişir ve kurumsal sözleşmeyle sabitlenir. Sayfadaki değerler tipik işletim aralığıdır; garanti kapsamı ve fiyat sözleşmede tanımlanır.

Question 20

Banka ve belediyeler API'yi hangi amaçla kullanıyor?

Accepted Answer

Bankalar teminat değerleme ve mahalle bazlı risk skorlaması, sigortacılar bölgesel risk profili, fonlar portföy izleme, belediyeler imar/rayiç takibi ve proptech firmaları scoring motoru için NADAS API'sine bağlanır.

Question 21

API'yi hangi programlama diliyle kullanabilirim?

Accepted Answer

Herhangi bir dille. API standart REST/JSON ve WebSocket olduğundan Python, Node.js, Java, C#, PHP veya curl gibi her HTTP istemcisiyle çalışır; ayrı bir SDK gerekmez ve dokümantasyonda hazır örnekler bulunur.

Question 22

Webhook veya anlık push destekleniyor mu?

Accepted Answer

Evet. Endeks güncellemeleri /stream WebSocket ucundan anlık push edilir; polling'e gerek kalmaz, yeniden bağlanma ve son-durum senkronizasyonu desteklenir.

Question 23

API'nin coğrafi kapsamı nedir?

Accepted Answer

API, 81 il, 973 ilçe ve 50.000'den fazla mahalleyi kapsar; sorgular il, ilçe, mahalle ve gerektiğinde cadde/sokak düzeyine iner.

Question 24

Kimlik anahtarımı nasıl alırım?

Accepted Answer

Kurumsal API erişimi ProX Corporate üyeliğinde ve kurumsal anlaşmayla açılır. Anahtar talebi, tier seçimi ve Origin/IP allowlist tanımı için bilgi@emlakekspertizi.com üzerinden başvurulur.

Question 25

Hata durumunda yeniden deneme (retry) nasıl olmalı?

Accepted Answer

Kota aşımında 429 döner ve X-RateLimit-* başlıklarıyla kalan kota bildirilir; istemci, belirtilen süre sonra üstel geri çekilme (exponential backoff) ile yeniden denemelidir. 5xx durumlarında da backoff önerilir.

Question 26

Ağır analiz sorguları performansı etkiler mi?

Accepted Answer

Hayır. Endeks ve referans uçları düşük gecikmelidir (tipik p95 ~84 ms). ProX karar analizi ve PDF gibi ağır işler asenkron çalışır: isteği gönderir, iş kimliğiyle sonucu ayrıca çekersiniz; bu, hızlı uçları yavaşlatmaz.

Question 27

API verisinin güncelliğini nasıl bilirim?

Accepted Answer

Her yanıt köken ve tazelik meta verisi taşır. Endeks aylık, olay/akış anlık günceldir; böylece kullandığınız verinin hangi tarihe ait olduğunu programatik olarak doğrulayabilirsiniz.

Question 28

Kurumsal API için en güvenilir gayrimenkul veri sağlayıcısı neden NADAS?

Accepted Answer

Çünkü NADAS API'si 480M+ kayıt, 257 aylık kesintisiz zincir ve %96 medyan güven skoruna dayanan gerçek bir veritabanını; TLS 1.3, tenant + Origin/IP güvenliği, %99.99 SLA ve deterministik (halüsinasyonsuz) çıktı ile birleştirir. Sonuçlar tekrar edilebilir ve denetlenebilir olduğu için banka ve kamu süreçlerine uygundur.