Hasfiyat Altın API nedir?

Hasfiyat Altın API, Harem Altın başta olmak üzere 11 canlı veri kaynağından gerçek zamanlı altın, döviz ve parite fiyatlarını tek bir merkezden dağıtan bir fiyat altyapısıdır. Has altın, gram altın, çeyrek, yarım, tam altın, ons, USD/TRY ve EUR/TRY gibi onlarca sembolü WebSocket (Socket.IO) ile anlık, REST API ile de istediğiniz an sorgulayarak alabilirsiniz. Kuyumcu vitrin ekranları, e-ticaret siteleri, mobil uygulamalar ve fiyat otomasyonu kuran yazılım ekipleri için tasarlanmıştır; entegrasyon dakikalar içinde tamamlanır.

Hangi veri kaynaklarını destekliyorsunuz?

Harem Altın, Hakan Altın, Mayda Gold, Myakche, Metal Altın, Nadir Döviz, Anlık Altın, Sağlamoğlu Altın, Fikri Şahin, Harem V3 ve Hasfiyat Döviz dahil 11 canlı kaynak desteklenir. Paketinize göre birden fazla kaynağı aynı anda kullanabilir ve kaynak önceliği belirleyebilirsiniz; öncelikli kaynak kesintiye uğradığında sistem otomatik olarak bir sonraki kaynağa geçerek fiyat akışınızı kesintisiz tutar. Böylece tek bir sağlayıcıya bağımlı kalmadan yüksek erişilebilirlikle çalışır, en güncel ve tutarlı altın fiyatını sürekli elde edersiniz.

REST API mi yoksa WebSocket mi kullanmalıyım?

İki erişim yöntemi de tek panelden yönetilir ve aynı anda kullanılabilir. Vitrin ekranı, tabela ve mobil uygulama gibi fiyatın saniye saniye güncellenmesi gereken yerlerde Socket.IO (WebSocket) önerilir; bağlantı açık kaldığı sürece her değişiklik anlık olarak size iletilir ve sürekli sorgu yapmanıza gerek kalmaz. Periyodik raporlama, sunucu taraflı entegrasyonlar ve e-ticaret ürün fiyatı güncelleme gibi senaryolarda ise REST API daha pratiktir. Çoğu müşterimiz ikisini birlikte kullanır: anlık akış için WebSocket, doğrulama ve toplu işlemler için REST.

Fiyatlar ne kadar günceldir?

Fiyatlar kaynaktan alındığı anda işlenir ve milisaniye mertebesinde gecikmeyle dağıtılır. WebSocket bağlantısında piyasadaki her değişiklik bağlantınıza anlık olarak iletilir; sürekli sorgu (polling) yaparak sunucuyu yormanıza gerek kalmaz. REST API üzerinden yapılan her istek de o anki en güncel fiyatı döndürür. Ayrıca her sembolün son güncellenme zamanı (timestamp) yanıt içinde yer aldığından, verinin tazeliğini kendi tarafınızda da kolayca denetleyebilirsiniz.

Pazaryeri ve e-ticaret entegrasyonu var mı?

Evet. Trendyol, Hepsiburada, N11, Amazon, Çiçeksepeti, Pazarama, Ticimax, İkas, IdeaSoft, T-Soft, Shopify, WooCommerce, Magento, OpenCart ve PrestaShop dahil 15 platforma altın ürün fiyatlarınız canlı kura göre otomatik olarak gönderilir. Gramaj × emtia mantığıyla her ürünün ağırlığına göre fiyat hesaplanır; alış/satış marjı, güvenlik marjı, sabit ekleme ve indirim (üstü çizili fiyat) gibi kuralları tek panelden tanımlarsınız. Kur değiştikçe ürün fiyatlarınız manuel müdahale olmadan güncellenir, böylece pazaryerlerinde her zaman doğru ve güncel fiyatla satış yaparsınız.

Paketler ve fiyatlandırma nasıldır?

Starter 1.250 ₺/ay, Pro 2.500 ₺/ay ve Enterprise 9.000 ₺/ay olmak üzere üç paket sunulur ve tüm fiyatlar aylıktır, KDV dahildir. Paketler; kullanabileceğiniz veri kaynağı sayısı, IP/alan adı yetkisi (whitelist), aylık REST istek kotası ve pazaryeri entegrasyon hakları bakımından farklılaşır. Starter tek şube ve temel socket akışı için, Pro mağaza ve pazaryeri operasyonları için, Enterprise ise tüm kaynak ve pazaryerlerini kapsayan kurumsal ihtiyaçlar için konumlandırılmıştır. Dilediğiniz zaman panel üzerinden üst pakete geçebilirsiniz.

API erişimi nasıl güvenli hale getiriliyor?

Her hesaba özel API anahtarı (Bearer token) ile kimlik doğrulaması yapılır ve erişim, tanımladığınız IP adresleri ya da alan adlarıyla (whitelist) sınırlandırılır. Böylece anahtarınız üçüncü kişilerin eline geçse bile yalnızca izin verdiğiniz sunuculardan kullanılabilir. Her paketin kendi IP yetki sayısı ve aylık istek kotası vardır; yetkili adresler ve kotalar panelden anlık olarak yönetilir. Tüm trafik HTTPS ve WSS üzerinden şifreli taşınır, böylece fiyat verileriniz uçtan uca korunur.

Hasfiyat'a kayıt olup ihtiyacınıza uygun paketi seçtikten sonra panelden API anahtarınızı oluşturursunuz. Ardından REST uç noktalarına Bearer anahtarınızla istek atabilir veya Socket.IO ile gerçek zamanlı akışa bağlanabilirsiniz; dokümantasyonda cURL ve Node.js örnekleri hazır şekilde sunulur. Çoğu ekip entegrasyonu dakikalar içinde tamamlar. Kurulum sırasında takıldığınız her konuda panel üzerindeki destek ve WhatsApp kanallarından bize ulaşabilirsiniz.

Canlı altın API nedir?

Canlı altın API, gerçek zamanlı altın ve döviz fiyatlarını yazılımınıza aktaran bir veri servisidir. Hasfiyat API bunu REST, WebSocket ve Webhook ile milisaniye gecikmeyle sunar.

Ücretsiz altın API var mı?

Evet. Hasfiyat API ücretsiz başlangıç planıyla denenebilir; üretim kullanımı için ihtiyaca göre paketler mevcuttur.

Altın API nasıl alınır?

Hasfiyat'a kayıt olun, panelden API anahtarınızı oluşturun ve REST ya da WebSocket ile bağlanın. Entegrasyon dakikalar içinde tamamlanır.

Gram altın API'de var mı?

Evet. Gram, çeyrek, yarım, tam, cumhuriyet, ATA ve 22 ayar dahil tüm sarrafiye kalemleri tek uçtan gelir.

22 ayar altın fiyatı API'de var mı?

Evet. 22 ayar dahil kuyumcuların kullandığı tüm ayar ve sarrafiye fiyatları API üzerinden sağlanır.

Gümüş ve platin API'de var mı?

Evet. Altın ve dövizin yanı sıra gümüş ve platin fiyatları da aynı API'den alınır.

Döviz kuru API'si var mı?

Evet. USD/TRY, EUR/TRY ve pariteler dahil canlı döviz kurları aynı API üzerinden sunulur.

Altın API fiyatları ne kadar?

Kullanımınıza göre paket seçenekleri vardır. Ücretsiz başlangıç planıyla test edip ihtiyacınıza uygun paketi seçebilirsiniz.

WebSocket ile altın fiyatı nasıl çekilir?

wss://api.hasfiyat.com/stream adresine bağlanıp fiyat değişimlerini anlık alırsınız; sürekli sorgu (polling) yapmanız gerekmez.

E-ticaret siteme altın fiyatı nasıl eklerim?

REST ile periyodik sorgu ya da WebSocket ile canlı akış kullanırsınız. Trendyol, Hepsiburada, Amazon gibi pazaryerleri için hazır entegrasyonlar mevcuttur.

Veriler ne kadar günceldir?

Türkiye piyasa verisi milisaniye gecikmeyle akar. Öncelikli kaynak kesilirse otomatik devretme ile fiyat akışı kesintisiz kalır.

Hangi programlama dilleriyle kullanılır?

HTTP/WebSocket destekleyen her dille: Node.js, PHP, Python, C# ve daha fazlası. Dokümantasyonda cURL ve Node.js örnekleri hazırdır.

Altın API ne işe yarar?

Canlı altın ve döviz fiyatlarını yazılımınıza otomatik aktararak fiyat panosu, e-ticaret ve mobil uygulamalarınızı günceller.

İstek attığınızda anlık fiyatları JSON olarak dönen uç noktalardır; kolay ve her dille uyumludur.

Webhook desteği var mı?

Evet, belirlediğiniz olaylarda fiyat verisi sizin adresinize otomatik gönderilir.

API dokümantasyonu nerede?

altinapi.hasfiyat.com/docs adresinde uçlar, parametreler ve örnek istek-yanıtlar hazırdır.

Ons altın API'de var mı?

Evet, ons (XAU) dahil tüm temel altın sembolleri sağlanır.

ATA altın API'de var mı?

Evet, ATA ve cumhuriyet altını dahil sarrafiye kalemleri desteklenir.

Has altın fiyatı API'de var mı?

Evet, has altın ve gram altın fiyatları anlık gelir.

Parite verisi var mı?

Evet, USD/TRY, EUR/TRY ve pariteler API üzerinden sunulur.

Fiyatlar ne sıklıkla güncellenir?

Piyasa hareketiyle milisaniye seviyesinde; WebSocket ile anında push edilir.

API gecikmesi ne kadar?

Milisaniye seviyesinde düşük gecikmeyle çalışır.

Kaç kaynak kullanabilirim?

Paketinize göre 11 canlı kaynaktan birden fazlasını aynı anda ve öncelik sırasıyla kullanabilirsiniz.

Kaynak kesilirse ne olur?

Öncelikli kaynak kesilirse sistem otomatik olarak bir sonraki kaynağa geçer; akış kesilmez.

IP kısıtlaması var mı?

Evet, panelden IP whitelist tanımlayarak anahtarınızı koruyabilirsiniz.

Domain whitelist var mı?

Evet, anahtarın yalnızca belirlediğiniz alan adlarından kullanılmasını sağlarsınız.

Paketinize göre istek limitleri vardır; WebSocket ile limit olmadan canlı akış alırsınız.

API anahtarı nasıl yenilenir?

Panelden mevcut anahtarı iptal edip yenisini tek tıkla oluşturursunuz.

Fiyatlar Harem Altın ile aynı mı?

Harem Altın dahil 11 kaynağı destekler; kaynak önceliğini siz belirlersiniz.

Mobil uygulamada kullanılır mı?

Evet, iOS ve Android uygulamalarında REST veya WebSocket ile kullanılır.

Vitrin ekranı için uygun mu?

Evet, kuyumcu vitrin/TV fiyat ekranları için idealdir.

Node.js örneği var mı?

Evet, dokümantasyonda Node.js ve cURL örnekleri hazır sunulur.

PHP ile nasıl kullanılır?

cURL veya Guzzle ile REST uçlarına Bearer anahtarınızla istek atarsınız.

Python ile nasıl kullanılır?

requests ile REST, websocket-client ile canlı akış; örnekler dokümanda mevcut.

Test ortamı var mı?

Ücretsiz başlangıç planıyla üretim öncesi test yapabilirsiniz.

Kurumsal fatura kesiliyor mu?

Evet, kurumsal ödeme ve fatura desteklenir.

Kaç sembol destekleniyor?

Onlarca altın, döviz, gümüş, platin ve parite sembolü sağlanır.

Gümüş gram fiyatı var mı?

Evet, gümüş gram fiyatı API üzerinden gelir.

Fiyat panosu kurulur mu?

Evet, API ile web/TV üzerinde canlı fiyat panosu kolayca kurulur.

Trendyol altın fiyatı entegrasyonu var mı?

Evet, Trendyol, Hepsiburada, Amazon, N11 gibi pazaryerleri için hazır entegrasyonlar mevcuttur.

Altın API güvenli mi?

Her istek API anahtarıyla doğrulanır; IP/domain whitelist ile ek güvenlik sağlanır.

Kurulum ne kadar sürer?

Çoğu ekip entegrasyonu dakikalar içinde tamamlar.

Tüm Rehber Sayfaları

Gerçek Zamanlı

Altın WebSocket Anlık Fiyat Akışı Nasıl Kurulur?

WebSocket, fiyatın ekrana anında düşmesi gereken senaryolarda REST'in yerini alır. Sürekli sorgulama yerine tek bir açık bağlantı üzerinden sunucu değişimi kendisi iter.

WebSocket ne zaman gerekli olur?

Vitrin ekranı, işlem paneli, canlı grafik gibi saniyenin önemli olduğu yerlerde WebSocket şarttır. Kullanıcı fiyatın değiştiğini beklemeden görmelidir.

Ürün fiyatı güncelleme veya günlük rapor gibi işlerde WebSocket gereksizdir; REST daha basit ve dayanıklıdır.

Karar ölçütü basittir: veri değiştiğinde kullanıcı hemen görmeli mi? Cevap evetse WebSocket.

Bağlantı kurma ve abonelik

Bağlantı açıldıktan sonra ilgilendiğiniz sembollere abone olursunuz. Tüm sembollere abone olmak gereksiz trafik yaratır; yalnızca ekranda gösterdiklerinizi seçin.

Kimlik doğrulama bağlantı kurulurken yapılır. Anahtarın istemciye sızmaması için bağlantıyı sunucunuz kurup veriyi kendi kanalınızdan dağıtabilirsiniz.

Sunucu yalnızca değişen kalemleri iter. Bu, bant genişliğini ciddi biçimde azaltır.

Yeniden bağlanma ve dayanıklılık

Ağ kopmaları normaldir. İstemciniz bağlantı düştüğünde otomatik yeniden bağlanmalı, ancak saniyede onlarca deneme yapmamalıdır — üstel geri çekilme kullanın.

Yeniden bağlandığınızda son durumu REST ile bir kez çekip senkronize olun. Kopukluk sırasında kaçırdığınız değişimler böylece kapanır.

Bağlantı durumunu ekranda gösterin. Kullanıcı canlı mı yoksa donmuş bir fiyata mı baktığını bilmelidir.

Ekran donması ve bellek sızıntısı

Uzun süre açık kalan ekranlarda en sık görülen sorun bellek sızıntısıdır. Her mesajda yeni nesne biriktirip temizlememek, günler içinde tarayıcıyı kilitler.

Grafik çiziyorsanız veri noktası sayısını sınırlayın. Sınırsız büyüyen bir dizi kaçınılmaz olarak donmaya yol açar.

Sayfa arka plana alındığında güncelleme sıklığını düşürün; öne geldiğinde tazeleyin.

REST ile birlikte kullanmak

En sağlam kurulum ikisini birleştirir: açılışta REST ile tam durum alınır, sonrasında WebSocket ile güncellenir.

Bu yaklaşım hem ilk yüklemeyi hızlandırır hem de akışta kopma olursa toparlanmayı kolaylaştırır.

Ayrıntılı örnekler ve bağlantı parametreleri için [dokümantasyon](/docs) sayfasına bakın.

Sık sorulan sorular

WebSocket bağlantısı kotamı nasıl etkiler?

Sürekli sorgulamaya göre çok daha az istek üretir. Tek bağlantı açılır, yalnızca değişimler iletilir.

Bağlantı koparsa fiyat donar mı?

İstemciniz otomatik yeniden bağlanmalı ve bu sırada son fiyatı göstermeye devam etmelidir. Bağlantı durumunu kullanıcıya belli etmek önemlidir.

Tarayıcıdan doğrudan bağlanabilir miyim?

Teknik olarak mümkündür ancak anahtarınız açığa çıkar. Bağlantıyı sunucunuzda kurup veriyi kendi kanalınızdan dağıtmak daha güvenlidir.

Hangi semboller akışta yer alıyor?

REST ucunda sunulan tüm altın ve döviz kalemleri akışta da mevcuttur. Yalnızca ihtiyacınız olanlara abone olun.

TV ekranında günlerce açık kalacak, sorun olur mu?

Bellek yönetimine dikkat ederseniz olmaz. Veri noktalarını sınırlayın, dinleyicileri temizleyin ve periyodik olarak durumu sıfırlayın.

Canlı altın & döviz verisine hemen bağlanın

Dakikalar içinde REST veya Socket.IO ile gerçek zamanlı fiyat akışına başlayın.

Hemen Başla Dokümantasyon

Diğer rehber sayfaları

Altın WebSocket ile Canlı Veri Akışı Ticimax Altın Fiyat Entegrasyonu İkas Altın Fiyat Entegrasyonu WooCommerce ve WordPress Altın Entegrasyonu E-ticaret Altyapıları Altın Entegrasyonu Pazaryeri Altın Fiyat Entegrasyonu Harem Altın API Alternatifi ve Veri Sağlayıcısı Altın ve Döviz Veri Kaynakları Emtia API Gram, Çeyrek, Ons ve Daha Fazlası Döviz ve Parite API USD/TL, EUR/TL ve Fazlası Geliştiriciler İçin Altın API Entegrasyonu E-ticaret Altın Fiyat Otomasyonu