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ı

Webhook

Altın Fiyat Webhook Değişimde Anında Bildirim

Webhook, sürekli sorgulama yapmadan haber almanın yoludur. Siz bir adres verirsiniz; fiyat değiştiğinde sistem o adrese bildirim gönderir.

Webhook ne zaman doğru seçim?

Sürekli izleme gerektirmeyen ama belirli bir eşikte harekete geçmesi gereken senaryolar için idealdir. Örneğin gram altın belirli seviyeyi aştığında pazaryeri fiyatlarını güncellemek.

REST ile her dakika sorgu atmak yerine, yalnızca olay gerçekleştiğinde bildirim almak hem kotanızı hem sunucunuzu korur.

Uç noktanızı hazırlamak

Kendi sunucunuzda POST kabul eden bir adres açarsınız. Gelen isteği hızlıca kabul edip işi arka plana atmak en doğru yaklaşımdır.

Yavaş yanıt veren uçlar yeniden deneme tetikler ve aynı bildirimi birden fazla kez alırsınız.

Güvenlik ve doğrulama

Gelen isteğin gerçekten bizden geldiğini doğrulamak için imza başlığı kullanılır. İmzayı doğrulamadan veriye güvenmeyin.

Uç adresinizi tahmin edilmesi zor tutun ve yalnızca beklenen IP aralığından gelen istekleri kabul edin.

Tekrar gelen bildirimler

Ağ koşulları nedeniyle aynı bildirim birden fazla kez ulaşabilir. Her bildirimin benzersiz kimliğini saklayıp tekrarları yok saymalısınız.

Bu, çift fiyat güncellemesi gibi istenmeyen sonuçları engeller.

İzleme ve hata ayıklama

Gelen bildirimleri en az birkaç gün loglayın. Sorun anında neyin geldiğini görmek çözümü hızlandırır.

Uç noktanız yanıt vermezse sistem belirli sayıda tekrar dener; sürekli başarısızlıkta bildirim durdurulabilir.

Sık sorulan sorular

Webhook ile REST farkı ne?

REST'te siz sorarsınız, webhook'ta sistem size haber verir. Webhook daha az istek üretir ve olay bazlı çalışır.

Bildirim gelmezse ne yapmalıyım?

Uç adresinizin dışarıdan erişilebilir olduğunu ve 200 döndüğünü kontrol edin. Panelden gönderim geçmişine bakılabilir.

Aynı bildirim iki kez gelirse?

Benzersiz kimliği saklayıp tekrarları yok sayın. Bu ağ koşullarında normaldir.

İmza doğrulaması nasıl yapılır?

Gövde ve gizli anahtarla üretilen imza, başlıktaki değerle karşılaştırılır.

Kaç webhook tanımlayabilirim?

Plan kapsamına göre değişir; farklı eşikler için ayrı uçlar tanımlanabilir.

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