Harem Altın API
Harem Altın, Kapalıçarşı referans fiyatlarıyla Türkiye'de en çok takip edilen altın fiyat kaynaklarının başında gelir.
Harem Altın, Kapalıçarşı'nın referans fiyatlarını yansıttığı için kuyumcu vitrininden e-ticaret fiyatlandırmasına kadar pek çok senaryoda kıyas noktası olarak kullanılır. Hasfiyat, Harem Altın akışını normalize eder ve tek tutarlı şemaya oturtur; böylece gram, çeyrek ve 22 ayar fiyatlarını hem REST ile anlık sorgular hem de Socket.IO ile kesintisiz canlı akış olarak alırsınız. Kaynak önceliği tanımlayıp Harem'i birincil kaynak seçebilir, kesinti anında otomatik yük devretmeyle akışı sürekli tutabilirsiniz.
GET /v1/prices?source=harem-altin-api
Authorization: Bearer API_KEY
// Canlı akış
socket.on('prices:harem-altin-api', (d) => {
console.log(d.symbol, d.buy, d.sell)
})Harem Altın API ile neler yapabilirsiniz?
REST API
Anlık fiyat sorgusu için basit ve hızlı REST uç noktaları.
Socket.IO
Kesintisiz canlı akışla milisaniye gecikmeli güncelleme.
Kaynak Önceliği
Birincil kaynak yanıt vermezse otomatik yük devretme.
IP Whitelist & API Key
Tek panelden güvenli, yetkilendirilmiş erişim.
Harem Altın hangi verileri sunar?
Gram altın, çeyrek, yarım, tam ve ATA altın 22 ayar, 18 ayar ve 14 ayar bilezik fiyatları HAS altın ve ons altın (XAU) USD ve EUR referans döviz kurları Kapalıçarşı bazlı alış / satış fiyat akışı
Harem Altın verisi Hasfiyat üzerinden nasıl akar?
Hasfiyat'ın toplayıcı süreçleri Harem Altın akışını kesintisiz dinler ve gelen her fiyatı ortak bir şemaya çevirerek bellek içi veri deposuna yazar. Sizin uygulamanız kaynağa değil, bu normalize katmana bağlanır.
Aradaki katman iki işe yarar: birincisi kaynağın alan adları veya biçimi değiştiğinde sizin kodunuzu bozmaz, ikincisi aynı sembolü farklı kaynaklardan aynı isimle almanızı sağlar.
Kapalıçarşı referansı ve sembol kapsamı
Harem Altın, Kapalıçarşı referans fiyatlarıyla Türkiye'de en yakından izlenen kaynakların başında gelir. Gram, çeyrek, yarım, tam ve ATA altının yanı sıra 22, 18 ve 14 ayar bilezik fiyatları, has altın ve ons altın bu akışta yer alır.
USD ve EUR serbest piyasa kurları da aynı akıştan gelir. Böylece vitrin ekranınız veya e-ticaret siteniz için ayrı bir döviz kaynağına bağlanmanız gerekmez.
Harem Altın API alternatifi arayanlar için
Tek bir kaynağa doğrudan bağlanmanın en büyük riski, o kaynak kesintiye uğradığında fiyat akışınızın tamamen durmasıdır. Vitrin ekranı ya da otomatik fiyatlandırma yapan bir sistemde bu, ekranın donması veya yanlış fiyattan satış demektir.
Hasfiyat'ta Harem Altın'ı birincil kaynak olarak seçip arkasına yedek kaynaklar tanımlarsınız. Birincil kaynak beslemeyi kestiğinde sistem otomatik olarak yedeğe geçer; toparlandığında geri döner.
Yedeğe geçiş nasıl karar veriliyor?
Karar iki ölçüte dayanır: verinin yaşı ve akışın sürekliliği. Tercih ettiğiniz kaynağın son güncellemesi belirlenen tazelik penceresinin dışına çıktığında yedek devreye alınır.
Geri dönüş kasıtlı olarak daha yavaştır. Tek bir taze yanıt görüp hemen geri dönmek, kaynağın saniyede bir değişmesine ve ekranda fiyatın zıplamasına yol açardı. Bu yüzden geri dönüş için kesintisiz bir tazelik süresi aranır.
REST mi, Socket.IO mu?
Vitrin ekranı, tabela ve mobil uygulama gibi fiyatın anlık yansıması gereken yerlerde Socket.IO önerilir; bağlantı açık kaldığı sürece her değişiklik size iletilir ve sürekli sorgu yapmanız gerekmez.
Sunucu taraflı entegrasyonlar, raporlama ve toplu fiyat güncelleme senaryolarında REST daha pratiktir. İkisi aynı anda kullanılabilir ve aynı şemayı döndürür.
Güvenlik ve erişim sınırları
Her hesaba özel API anahtarı ile kimlik doğrulanır; erişim, tanımladığınız IP adresleri veya alan adlarıyla sınırlandırılabilir. Anahtarınız üçüncü kişilerin eline geçse bile yetkisiz sunuculardan kullanılamaz.
Tüm trafik şifreli taşınır. Paketinize göre IP yetki sayısı ve aylık istek kotası belirlenir; ikisi de panelden anlık yönetilir.
Vitrin ekranı ve tabela senaryosunda beklenen davranış
Kuyumcu vitrinindeki ekran günlerce kapatılmadan çalışır ve müşteri fiyatı oradan okur. Böyle bir kullanımda iki şey kabul edilemez: ekranın donması ve fiyatın sürekli zıplaması.
Donmayı önlemek için verinin yaşı sürekli denetlenir; kaynak beslemeyi kesse bile yedek devreye girer ve ekran çalışmaya devam eder. Zıplamayı önlemek içinse geri dönüş şartı sıkı tutulmuştur: kaynağın toparlandığını kabul etmek için kesintisiz bir tazelik süresi aranır, tek bir taze yanıtla karar verilmez.
E-ticaret fiyatlandırmasında kullanım
Altın ürün satan bir sitede fiyatın kura bağlı olması gerekir. Ürün gramajını canlı kurla çarpıp marjınızı eklediğinizde, sitenizdeki fiyat piyasayla uyumlu kalır.
Burada kritik nokta, kurun ne kadar taze olduğudur. Yanıtta dönen zaman damgası sayesinde uygulamanız verinin yaşını kendi tarafında da denetleyebilir ve gerekirse fiyat göstermek yerine uyarı verebilir.
Doğrudan bağlanmak yerine aracı katman kullanmanın karşılığı
Kapalıçarşı referansına doğrudan bağlanmak ilk bakışta en kısa yol görünür. Gerçek maliyet sonradan çıkar: alan adları değişir, bağlantı kopar, hafta sonu akış seyrekleşir. Her biri sizin tarafınızda ayrı kod ve ayrı izleme demektir.
Aracı katman bu işlerin tamamını üstlenir. Uygulamanızın bilmesi gereken tek şey sembol adı ve fiyat alanıdır; kaynak tarafındaki her değişiklik sizden önce burada karşılanır.
Sık sorulan sorular
Harem Altın API neden referans kaynak sayılır?
Harem Altın fiyatları Kapalıçarşı referansını yansıttığı için sektörde yaygın bir kıyas noktasıdır; Hasfiyat bu akışı normalize ederek tek şemada sunar.
Harem Altın verisini canlı akış olarak alabilir miyim?
Evet. Socket.IO uç noktasıyla gram, çeyrek ve 22 ayar fiyatlarını canlı olarak canlı akış olarak, REST ile de anlık sorgu olarak alırsınız.
Harem kaynağı kesilirse ne olur?
Kaynak önceliği ve otomatik yük devretme sayesinde Harem kesildiğinde akış tanımladığınız yedek kaynaktan kesintisiz devam eder.
Harem Altın kesintiye uğrarsa fiyat akışım durur mu?
Hayır. Yedek kaynak tanımladıysanız sistem otomatik olarak ona geçer, birincil kaynak toparlandığında geri döner.
Verinin ne kadar taze olduğunu görebilir miyim?
Evet. Her sembolün son güncellenme zamanı yanıt içinde döner; tazeliği kendi tarafınızda da denetleyebilirsiniz.
Döviz için ayrı kaynağa bağlanmam gerekir mi?
Hayır. USD ve EUR serbest piyasa kurları aynı akışta yer alır.
Harem Altın'ın resmi bir fiyat API'si var mı?
Harem Altın'ın geliştiricilere açık, dokümante edilmiş resmi bir REST API'si bulunmuyor. Harem fiyatlarını uygulamanızda kullanmak isterseniz Hasfiyat API'si üzerinden Harem dahil 14 kaynağın verisini tek ve standart bir REST + WebSocket arayüzüyle çekebilirsiniz.
Harem Altın fiyatları ne kadar güncel geliyor?
Hasfiyat, Harem verisini kaynaktan geldiği anda işler ve fiyat değiştiği anda REST üzerinden güncel değeri, WebSocket üzerinden ise canlı akışı sunar. Böylece Harem gram ve has altın kurlarını neredeyse anlık takip edebilirsiniz.
Harem üzerinden hangi altın ve döviz sembollerini alabilirim?
Hasfiyat'ın Harem kaynağı gram altın, has altın, çeyrek, yarım, tam, ata, cumhuriyet ve reşat gibi sarrafiye ürünlerinin yanında ons (XAU), gümüş ve USD/EUR pariteleri dahil 67+ sembolü kapsar. Her sembol için alış ve satış fiyatı ayrı ayrı gelir.
Harem yerine neden Hasfiyat API'sini tercih etmeliyim?
Doğrudan Harem'e bağlanmak yerine Hasfiyat kullanmanın avantajı, tek bir API anahtarıyla Harem dahil 14 kaynağa erişmeniz ve Harem kesintiye girdiğinde otomatik failover ile fiyatın kesilmemesidir. Ayrıca standart JSON çıktı, WebSocket ve webhook desteğiyle entegrasyon çok daha hızlıdır.
Harem kaynağı kesintiye girerse fiyatlar durur mu?
Hayır. Hasfiyat çoklu kaynak mimarisi kullandığı için Harem geçici olarak düşerse fiyat otomatik olarak diğer kaynaklardan (örneğin Hakan veya Nadir Döviz) beslenmeye devam eder. Bu failover sayesinde uygulamanızda fiyat akışı kesintisiz kalır.
Harem Altın alış ve satış fiyatlarını ayrı ayrı çekebilir miyim?
Evet. Hasfiyat her sembol için Harem'in alış (buy) ve satış (sell) değerlerini ayrı alanlarda döndürür. Böylece sarrafiye ekranınızda veya e-ticaret fiyatlandırmanızda alış-satış farkını doğru şekilde gösterebilirsiniz.
Harem verisini WebSocket ile anlık olarak alabilir miyim?
Evet. Hasfiyat, Harem fiyatlarını Socket.IO tabanlı WebSocket kanalıyla canlı olarak yayınlar; her fiyat değişiminde sunucu size push eder, sürekli sorgu (polling) yapmanıza gerek kalmaz. Kritik ekranlar için ayrıca webhook tetiklemesi de kullanılabilir.
Harem Altın API entegrasyonunu Python veya PHP ile nasıl yaparım?
Hasfiyat standart bir REST API sunduğu için Harem verisini Python'da requests, PHP'de cURL gibi herhangi bir HTTP kütüphanesiyle çekebilirsiniz. API anahtarınızı Authorization header'ında gönderip JSON yanıtını ayrıştırmanız yeterlidir; anlık akış için WebSocket istemcisi eklersiniz.
Harem gram altın fiyatını canlı çekmek için ne yapmalıyım?
Hasfiyat'a API anahtarınızla bağlanıp gram altın sembolünü sorgulamanız yeterli; Harem kaynaklı gram altın alış-satış değerini anında alırsınız. Sürekli takip için aynı sembole WebSocket üzerinden abone olarak fiyat değiştikçe güncel değeri push olarak alabilirsiniz.
Harem Altın ons (XAU) fiyatını da veriyor mu?
Evet. Hasfiyat'ın Harem kaynağı ons altın (XAU) değerini de sunar; gram ve sarrafiye fiyatlarının yanında uluslararası ons paritesini de aynı API üzerinden takip edebilirsiniz. Gümüş, platin ve paladyum gibi diğer değerli metaller de kapsam içindedir.
Harem fiyatlarını Trendyol veya WooCommerce mağazama nasıl bağlarım?
Hasfiyat, Harem verisini Trendyol, Hepsiburada, N11 gibi pazaryerleri ve WooCommerce, Shopify, OpenCart gibi e-ticaret altyapılarıyla entegre edebileceğiniz bir yapıda sunar. Harem gram altın kuru değiştikçe ürün fiyatlarınızı otomatik güncelleyebilirsiniz.
Harem verisiyle kripto veya BIST hisse fiyatı alabilir miyim?
Hayır. Harem kaynağı ve Hasfiyat API'sinin odağı altın, döviz ve sarrafiye ürünleridir; kripto para ve BIST hisse senedi fiyatları kapsam dışıdır. Harem üzerinden yalnızca altın, gümüş, değerli metal ve döviz pariteleri sağlanır.
Harem Altın API ile hemen entegre olun
Dakikalar içinde REST veya Socket.IO ile canlı veriye bağlanın.