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ı

Başlangıç

Ücretsiz Altın Fiyat API ile Başlamak İlk 30 Dakika

Bu rehber, hiç deneyimi olmayan birinin ücretsiz planla ilk çalışan entegrasyonu kurmasını adım adım anlatır.

İlk 10 dakika: hesap ve anahtar

Kayıt olun, panele girin ve API anahtarınızı kopyalayın. Anahtarı bir metin dosyasına değil, ortam değişkenine koyun.

Anahtarı kimseyle paylaşmayın; sızarsa panelden yenileyebilirsiniz.

İkinci 10 dakika: ilk istek

Terminalden curl ile tek satırlık bir çağrı atın ve yanıtın geldiğini görün. Bu, en hızlı doğrulama yöntemidir.

Yanıt gelmiyorsa anahtarı ve adresi kontrol edin; hata mesajı genellikle sorunu söyler.

Son 10 dakika: koda taşımak

Dokümantasyondaki örnek kodu kendi projenize kopyalayın ve çalıştırın. Yanıtı ekrana basarak doğrulayın.

Ardından ihtiyacınız olan alanı ayıklayıp kullanmaya başlayın.

Sonraki adımlar

Önbellek ekleyin, hata durumlarını ele alın ve zaman damgası kontrolü koyun. Bu üçü entegrasyonu üretime hazır hâle getirir.

Trafiğiniz arttığında ücretli plana geçmeyi planlayın.

Sık takılınan yerler

En sık hata, anahtarın yanlış başlıkta gönderilmesidir. İkincisi zaman aşımı süresinin tanımlanmamasıdır.

Üçüncüsü yanıtı doğrulamadan doğrudan kullanmaktır; eksik alan geldiğinde uygulama hata verir.

Sık sorulan sorular

Gerçekten 30 dakikada kurulur mu?

Temel bir entegrasyon için evet; üretime hazır hâle getirmek biraz daha sürer.

Kredi kartı gerekiyor mu?

Ücretsiz plan için genellikle gerekmez.

Anahtarımı nereye koymalıyım?

Ortam değişkenine; koda gömmeyin ve sürüm kontrolüne göndermeyin.

İlk istekte hata alırsam?

Hata mesajını okuyun; genellikle anahtar veya adres hatasını söyler.

Sonra ne yapmalıyım?

Önbellek, hata yönetimi ve zaman damgası kontrolü ekleyin.

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