Türkiye odaklı finans, muhasebe veya raporlama ürünü geliştiriyorsanız TCMB verisi çoğu zaman ilk bakılacak kaynaklardan biridir. Fakat TCMB tarafında iki farklı kullanım ihtiyacı vardır: günlük kur bülteni okumak ve geniş ekonomik zaman serileriyle çalışmak.
Bu yazıda API Deposu'ndaki TCMB EVDS ve TCMB Günlük Kurlar XML kayıtlarını birlikte ele alıyoruz. Amaç hangi üründe hangi kaynağın daha sade, daha sürdürülebilir veya daha kapsamlı olduğunu netleştirmek.
Hızlı karar tablosu
| İhtiyaç | Önerilen kaynak | Neden |
|---|---|---|
| Bugünün döviz kurunu göstermek | TCMB Günlük Kurlar XML | Basit ve anahtarsız okuma |
| Tarihli kur arşivi okumak | TCMB Günlük Kurlar XML | Tarihli XML dosyalarıyla çalışır |
| Ekonomik seri analizi yapmak | TCMB EVDS | Geniş zaman serisi kapsamı |
| Grafik, rapor ve veri keşfi | TCMB EVDS | Kategori ve seri yapısı daha güçlü |
Günlük kur XML ne zaman yeterli?
TCMB Günlük Kurlar XML, kur göstergesi, basit çevirici, fiyat ekranı veya muhasebe yardımcı aracı için yeterli olabilir. today.xml aktif bülteni verir; tarihe göre arşiv dosyaları da belirli path yapısıyla okunabilir.
Bu kaynakla çalışırken iş günü davranışını hesaba katın. Hafta sonu veya resmi tatilde yeni bülten yayınlanmayabilir; tarihe göre dosya bulunamadığında uygulamanın 404 durumunu normal bir sonuç gibi yönetmesi gerekir. Kullanıcıya "son yayınlanan bülten" bilgisini göstermek güveni artırır.
EVDS ne zaman gerekli?
TCMB EVDS, sadece kur değil; faiz, enflasyon, para ve makroekonomik göstergeler gibi daha geniş zaman serileri gerektiğinde anlamlıdır. Ekonomi paneli, akademik analiz aracı, iç raporlama veya veri görselleştirme ürünü yapıyorsanız EVDS daha doğru katmandır.
EVDS entegrasyonu günlük XML'e göre daha fazla modelleme ister. Kategori, seri kodu, tarih aralığı, çıktı formatı ve API anahtarı gibi kararları netleştirmeniz gerekir. Bu yüzden EVDS'i uygulamanın her yerine doğrudan çağırmak yerine küçük bir veri servisinin arkasına koymak daha sağlıklıdır.
Üretim mimarisi
Kur verisini UI'da doğrudan API yanıtından okumayın. Kendi modelinizde source, seriesCode, date, currency, buyingRate, sellingRate, fetchedAt gibi alanları ayırın. Böylece günlük XML ile başlayan bir ürün ileride EVDS veya başka resmi kaynakla genişleyebilir.
Cache stratejisi de ürün tipine göre ayrılmalıdır. Bugünkü kur kartı için kısa veya gün sonuna kadar cache yeterli olabilir. Tarihli arşiv verisi ise değişmeyeceği varsayımıyla daha uzun saklanabilir. Ekonomik seri ekranlarında sorgu parametreleri cache anahtarına dahil edilmelidir.
Hata yönetimi
Eksik veri geldiğinde sıfır kur basmak en tehlikeli hatalardan biridir. Kur yoksa hesaplama yapılmamalı, kullanıcıya veri bulunamadığı açıkça gösterilmelidir. Finansal ekranlarda eski veri gösterilecekse bu durum "son güncelleme" etiketiyle belirtilmelidir.
Ayrıca API anahtarı gereken EVDS çağrılarında anahtarın frontend'e çıkmadığından emin olun. Backend üzerinden çağırmak, anahtarı korumak ve rate limit davranışını merkezi yönetmek için daha doğru bir yaklaşımdır.
Veri sunumu ve kullanıcı güveni
Kur ve ekonomik seri verisi gösteren ürünlerde kaynak şeffaflığı önemlidir. Kullanıcıya sadece sayı göstermek yerine kaynak, tarih, seri adı ve mümkünse veri yayın zamanı gösterilmelidir. Özellikle muhasebe ve raporlama ekranlarında "hangi kur kullanıldı" sorusu sonradan denetlenebilir olmalıdır.
Grafik ekranlarında eksik günleri sıfır gibi çizmek yerine boş veri olarak işlemek gerekir. Hafta sonu, resmi tatil veya yayın yapılmayan günlerde dosya bulunmaması hata olmayabilir. Uygulama bu ayrımı bilmezse kullanıcıya yanlış finansal eğilim gösterebilir.
EVDS ile çalışırken seri kodlarını konfigürasyon gibi yönetin. Kodlar UI içine gömülürse yeni seri eklemek veya eski seriyi değiştirmek gereksiz deploy gerektirir. Daha iyi model, backend tarafında onaylı seri listesini tutmak ve UI'a sadece anlamlı etiketleri göstermektir.
İlgili API Deposu kayıtları
Kaynaklar
Sık Sorulan Sorular
›TCMB EVDS ile günlük kur XML arasındaki fark nedir?
Günlük kur XML akışı tek iş için sade bir kaynaktır: güncel veya arşivlenmiş döviz bülteni okumak. EVDS ise daha geniş ekonomik zaman serileri ve analiz ihtiyacı için kullanılır.
›TCMB EVDS API anahtarı gerektirir mi?
EVDS entegrasyonunda API anahtarı kullanılır ve katalog notuna göre anahtar header üzerinden gönderilmelidir. Günlük kur XML akışı ise basit okuma senaryolarında anahtarsız erişilebilir.
›Muhasebe ürünü için hangi kaynak daha uygun?
Sadece günlük döviz kuru gerekiyorsa TCMB günlük XML daha basittir. Çoklu ekonomik seri, tarih aralığı veya analiz gerekiyorsa EVDS daha doğru kaynaktır.
›Kur verisi üretimde nasıl cache'lenmeli?
Günlük kur bülteni sık değişen bir veri değildir; iş günü ve yayın saati dikkate alınarak cache kullanılmalıdır. Tarihli arşiv dosyaları daha uzun süre saklanabilir.
