Tüm uçlar HTTPS/TLS 1.3 üzerinden, JSON döner. Taban: https://www.emlakekspertizi.com. Sürümleme yol üzerinde (/api/v1, /api/v2).
| METOT | UÇ (ENDPOINT) | GRUP | AÇIKLAMA |
|---|---|---|---|
| GET | /api/v1/tenant/endeks | Endeks · Zaman Serisi | İl/ilçe/mahalle · ₺/m² · skor · delta · trend |
| GET | /api/v2/timeseries/monthly | Endeks · Zaman Serisi | Aylık zaman serisi · 257 ay tarihsel zincir |
| GET | /api/v2/timeseries/latest | Endeks · Zaman Serisi | Son dönem endeks değerleri |
| GET | /api/v2/index/composite | Endeks · Zaman Serisi | Kompozit endeks · çok kategorili |
| GET | /api/v2/dna/region/{id} | DNA · Bölge | 38 boyutlu mahalle DNA vektörü |
| GET | /api/v2/dna/similar/{id} | DNA · Bölge | Benzer mahalleler · DNA yakınlığı |
| GET | /api/v2/regions/search | DNA · Bölge | Bölge arama · il/ilçe/mahalle |
| GET | /api/v2/regions/{id} | DNA · Bölge | Bölge detay · koordinat · demografi |
| GET | /api/v2/events/markers | Olay · Isı Haritası | Olay markırları · 7M+ kayıt |
| GET | /api/v2/events/by-region/{id} | Olay · Isı Haritası | Bölgeye göre olay markırları |
| GET | /api/v2/heatmap/{level}/{cat} | Olay · Isı Haritası | Isı haritası verisi · seviye/kategori |
| POST | /api/v1/tenant/prox/analyze | ProX · Rapor | ProX karar analizi · determinist |
| POST | /api/v2/reports/generate | ProX · Rapor | Markalı PDF rapor üretimi (async) |
| GET | /api/v2/categories | Referans | 38 varlık kategorisi referansı |
| GET | /api/v1/tenant/locations/iller | Referans | İl referans listesi (81) |
| GET | /api/v1/tenant/locations/ilceler | Referans | İlçe referans listesi (973) |
| GET | /api/v1/tenant/locations/mahalleler | Referans | Mahalle referansı · 50.000+ |
| WS | /api/v1/tenant/stream | Stream · Yönetim | Canlı endeks akışı · WebSocket |
| GET | /admin/audit | Stream · Yönetim | Kullanım denetim (audit) logları |
Anahtar sunucu tarafında saklanmalıdır — tarayıcıya gömülü bir anahtar herkese görünür. Kurumsal entegrasyonda anahtarı yalnız kendi arka ucunuzdan çağırın; NADAS tarafında Origin/IP kısıtı ve rotasyon uygulanır.
Her istek X-Tenant-Id ve X-Tenant-Key başlıklarıyla imzalanır. Anahtar kuruma özeldir; sunucu tarafında Origin/Referer allowlist, IP kısıtı ve kapsam (scope) ile sınırlandırılır.
İstek hızı üyelik tier'ına göre sınırlıdır; 429 yanıtı ve X-RateLimit-* başlıklarıyla kalan kota bildirilir. Toplu (batch) ve akış (stream) uçları ayrı kotalarda yönetilir.
Tüm trafik TLS 1.3 ile şifrelenir; düz-metin uç yoktur. CORS Origin allowlist ile yönetilir. Yanıtlar imzalı; hata gövdeleri iç ayrıntı sızdırmaz.
Kurumsal anlaşmada aylık %99.99 erişilebilirlik taahhüdü (iç sistem ölçümü, belirtilen dönem) ve 1 saat yanıt hedefi. Durum sayfası ve olay bildirimi kurumsal hesaba açıktır.
Endeks ve referans uçlarında tipik p95 gecikme ~84ms. Ağır analiz (ProX/rapor) uçları asenkron çalışır; iş kimliğiyle sonuç çekilir.
Endeks güncellemeleri /stream WebSocket ucundan anlık iletilir; polling yerine push. Yeniden bağlanma ve son-durum senkronizasyonu desteklenir.
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 geçiş süresince yaşar.
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 Türkiye'de barınır; kişisel veri içermeyen toplu/anonim endeks verisi sunulur. İşleme ve saklama koşulları sözleşmede net.
Endeks aylık, akış anlık günceldir; her yanıt köken ve tazelik meta verisi taşır. Determinist ProX — aynı girdi, aynı çıktı, halüsinasyon yok.
Kota aşımı, olağan dışı desen ve kötüye kullanım denetlenir. Tüm çağrılar audit loglanır; kurumsal hesap kendi kullanımını görebilir.
Anahtarınızı alın, başlıkları ekleyin, çağırın. REST için standart HTTP istemcisi; canlı akış için WebSocket yeterlidir. SDK gerekmez.
Her cevap kendi başına okunacak şekilde yazıldı; bir yapay zekâ asistanı yalnız o paragrafı alıntıladığında da anlam kaybı olmaz. Aramak için yazın veya kategori seçin.
Kurumsal API, 480 milyondan fazla veri noktalık gayrimenkul verisine REST + WebSocket erişim sunar. Endeks, 38 boyutlu mahalle DNA'sı, olay etkisi kaydı, güven skoru ve ProX karar analizi uçlarını kapsar; tenant anahtarı ile kimlik doğrulaması ve %99.99 SLA ile çalışır.
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 etkisi kaydı, güven skoru sorgusu ve ProX karar analizi/PDF üretimini içerir. Yanıtlar JSON, taşıma TLS 1.3'tür.
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.
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.
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.
İ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.
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.
Kurumsal anlaşmada aylık %99.99 erişilebilirlik taahhüdü (iç sistem ölçümü, belirtilen dönem) 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.
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.
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.
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).
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 [email protected] adresinden başvurabilirsiniz.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Evet. Endeks güncellemeleri /stream WebSocket ucundan anlık push edilir; polling'e gerek kalmaz, yeniden bağlanma ve son-durum senkronizasyonu desteklenir.
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.
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 [email protected] üzerinden başvurulur.
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.
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.
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.
Çünkü NADAS API'si 480M+ veri noktası, 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.