Döviz ve Altın Kuru API’si ile Canlı Fiyat Göstermek

Bir kuyumcunun vitrinindeki fiyat tablosu, bir ithalatçının teklif formundaki kur ya da bir e-ticaret sitesinin döviz bazlı ürün fiyatı: hepsi aynı soruya dayanır. Bu fiyat nereden geliyor ve ne kadar güncel? Döviz ve altın kuru API entegrasyonu, bu verileri bir kaynaktan otomatik çekip sitenizde, panelinizde ya da mobil uygulamanızda göstermenizi sağlar. Bu yazıda veri kaynağı seçimini, sunucu tarafındaki mimariyi, önbelleği ve kaynak çöktüğünde ne olacağını anlatıyorum.

Kur verisi nereden gelir?

Kur ve altın fiyatı verisi için birkaç farklı kaynak türü vardır ve her birinin amacı farklıdır:

• Resmî referans kurlar: Merkez bankalarının günlük olarak yayımladığı gösterge niteliğindeki kurlar. Muhasebe ve resmî hesaplamalar için referans alınır, ancak gün içinde anlık değişmez.
• Piyasa veri sağlayıcıları: Gün içinde sık güncellenen döviz, ons ve gram altın verilerini API ile sunan ticari servisler.
• Sektörel kaynaklar: Kuyumculukta sarrafiye ürünleri (çeyrek, yarım, tam, ata gibi) için piyasada referans alınan fiyat kaynakları.
• Kendi fiyatınız: Birçok işletme kaynaktan gelen fiyatın üzerine kendi marjını ekler ya da bazı kalemleri elle belirler.

Hangi kaynağın kullanılacağı; verinin ne sıklıkla güncellenmesi gerektiğine, ticari kullanım izni olup olmadığına ve bütçenize bağlıdır. Her sağlayıcının kullanım şartları, güncelleme sıklığı ve ücret yapısı farklıdır ve değişebilir; güncel bilgiyi sağlayıcının kendi sitesinden kontrol etmeniz gerekir. Özellikle başka bir sitenin sayfasından izinsiz veri kazımak hem hukuki hem teknik açıdan sorunludur; sayfa yapısı değiştiğinde sistem bir gecede bozulur.

Döviz ve altın kuru API için doğru mimari

Mimarinin temel kuralı basittir: ziyaretçi veri kaynağına değil, sizin sunucunuza bağlanır. Döviz ve altın kuru API entegrasyonunda performans, güvenlik ve maliyet sorunlarının neredeyse tamamı bu kurala uyulmamasından doğar.

En sık yapılan hata, her ziyaretçinin tarayıcısından doğrudan veri sağlayıcısına istek atılmasıdır. Bu yaklaşım hem API anahtarınızı açığa çıkarır hem de ziyaretçi sayısı arttıkça kota ve maliyet sorununa yol açar. Doğru kurgu şöyledir:

1. Sunucunuzdaki bir görev, belirlediğiniz aralıklarla veri kaynağından kurları çeker.
2. Gelen veri doğrulanır: boş, sıfır ya da önceki değere göre mantıksız ölçüde sapmış fiyatlar reddedilir.
3. Geçerli veri, zaman damgasıyla birlikte önbelleğe ve veritabanına yazılır.
4. Siteniz, paneliniz ve mobil uygulamanız bu veriyi sizin kendi API’nizden okur.

Bu sayede bin ziyaretçi de gelse veri kaynağına giden istek sayısı sabit kalır. Önbelleğin genel mantığını API önbellekleme yazısında ayrıntılı anlattım.

Kaynak erişilemezse ne olur?

Dış kaynaklar zaman zaman yanıt vermez, yavaşlar ya da hatalı veri döndürür. Böyle bir anda sitenizde boş bir tablo ya da sıfır fiyat görünmesi, özellikle kuyumculukta ciddi bir güven sorunudur. İyi bir sistem şu önlemleri içerir:

• Son geçerli fiyatı göstermek: Yeni veri alınamazsa en son doğrulanmış fiyat gösterilmeye devam eder.
• Güncellik bilgisini açıkça yazmak: “Son güncelleme: 14.32” gibi bir ibare, ziyaretçinin verinin ne kadar taze olduğunu bilmesini sağlar.
• Yedek kaynak: Mümkünse ikinci bir kaynak tanımlanır; birincisi başarısız olursa ona geçilir.
• Uyarı: Veri belirli bir süreden uzun süre güncellenemezse işletme sahibine bildirim gider.

Fiyat hesaplama ve marj

Kaynaktan gelen ham fiyat çoğu zaman doğrudan gösterilmez. Alış ve satış fiyatı arasındaki fark, işçilik, ürün türüne göre çarpanlar gibi kurallar sunucu tarafında hesaplanır. Bu kuralların yönetim panelinden değiştirilebilmesi, her fiyat değişikliğinde geliştiriciye ihtiyaç duyulmamasını sağlar. Hesaplamada yuvarlama kurallarının baştan belirlenmesi de önemlidir; aksi halde sitedeki fiyat ile kasadaki fiyat arasında küçük ama can sıkıcı farklar oluşur.

Döviz bazlı ürün satan e-ticaret sitelerinde ise ayrı bir karar gerekir: sepetteki fiyat, ürün sepete eklendiği andaki kurla mı, yoksa ödeme anındaki kurla mı hesaplanacak? Bu kural müşteriye açıkça gösterilmeli ve sipariş kaydında kullanılan kur da saklanmalıdır.

Gösterim seçenekleri

Aynı veri farklı yerlerde farklı biçimlerde kullanılabilir:

Kullanım yeri	Biçim	Not
Kurumsal site	Fiyat tablosu, kayan şerit	WordPress’te kısa kodlarla yerleştirilebilir
Mağaza ekranı	Tam ekran tablo	Belirli aralıklarla kendini yeniler
Mobil uygulama	Liste ve bildirim	Aynı API’den beslenir
E-ticaret	Ürün fiyatına otomatik yansıma	Gram ve işçilik kuralıyla hesaplanır

Örnek: Kuyumcu için eklenti ve mobil uygulama

Bu mimarinin somut bir örneği, kuyumcular için geliştirdiğim altın fiyatları eklentisi ve mobil uygulama. Eklenti canlı altın, sarrafiye ve ons fiyatlarını önbellekli bir REST API üzerinden sunar; kaynak erişilemezse son geçerli fiyatı gösterir. Sitede fiyatlar kısa kodlarla istenen sayfaya yerleştirilir, aynı veri Flutter ile geliştirilen mobil uygulamada da kullanılır. Ağrı Eleşkirt’teki Nazım Kuyumculuk sitesindeki canlı fiyat tablosu bu yapıyla çalışıyor.

Bu işi nasıl birlikte yaparız?

1. İhtiyacı dinlerim: Hangi kurları ve ürünleri göstermek istediğinizi, ne sıklıkla güncelleme gerektiğini ve fiyatlarınıza hangi kuralları uyguladığınızı öğrenirim.
2. Kaynak ve kapsamı belirleriz: Uygun veri kaynağını, yedek kaynak ihtiyacını, gösterim yerlerini (site, ekran, uygulama) netleştirip teklif hazırlarım.
3. Geliştirir ve test ederim: Veri çekme, doğrulama, önbellek ve hesaplama katmanını kurar; kaynağın kesildiği senaryoyu da bilerek deneriz.
4. Teslim ve destek: Paneli size tanıtır, fiyat kurallarını birlikte ayarlarız. Kaynak tarafında değişiklik olduğunda entegrasyonu güncel tutarım.

Kendi sisteminizi konuşmak için iletişim sayfasından ulaşabilirsiniz.

Sık sorulan sorular

Kurlar ne sıklıkla güncellenmeli?

Bu, işinize ve veri kaynağının sunduğu imkâna bağlıdır. Kuyumculukta gün içinde sık güncelleme beklenirken, kurumsal bir sitede günlük referans kur yeterli olabilir.

Ücretsiz kur kaynakları kullanılabilir mi?

Bazı kaynaklar ücretsiz veri sunar, ancak ticari kullanım izni, güncelleme sıklığı ve süreklilik konusunda sınırlamaları olabilir. Kullanım şartlarını mutlaka sağlayıcının sitesinden kontrol edin.

Kaynak çökerse sitemde yanlış fiyat görünür mü?

Doğru kurulmuş bir sistemde hayır. Gelen veri doğrulanır, geçersizse reddedilir ve son geçerli fiyat güncellik bilgisiyle birlikte gösterilmeye devam eder.

Kendi marjımı ekleyebilir miyim?

Evet. Alış ve satış farkı, işçilik ve ürün bazlı çarpanlar yönetim panelinden tanımlanabilir; fiyatlar bu kurallara göre otomatik hesaplanır.

Sonuç

Döviz ve altın kuru API entegrasyonu, fiyatlarınızı elle güncelleme yükünden kurtarır ve müşterinize güncel bilgi sunar. Doğru kaynak seçimi, sunucu tarafında önbellek ve kaynak kesintisine karşı önlemler, sistemin güvenilirliğini belirler. Kendi işletmeniz için uygun yapıyı konuşmak isterseniz bana yazabilirsiniz.