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ıç

Altın Fiyatlarını API ile Çekme Adım Adım Uygulama

Altın fiyatlarını API ile çekmek ilk bakışta tek satırlık bir iş gibi görünür, ama üretimde ayakta kalan bir entegrasyon birkaç ayrıntıya daha ihtiyaç duyar. Bu yazı sıfırdan çalışan bir kurulumu adım adım anlatır.

Adım 1: Hesap ve API anahtarı

Panele kaydolduktan sonra size bir API anahtarı verilir. Bu anahtar isteklerinizi tanımlar ve kotanızı takip eder.

Anahtarı kaynak koduna gömmeyin. Ortam değişkeni (.env) kullanın ve sürüm kontrolüne göndermeyin.

Anahtarınız sızdıysa panelden yenileyin; eski anahtar anında geçersiz olur.

Adım 2: İlk isteği atmak

En basit test `GET /api/prices` çağrısıdır. Terminalden curl ile deneyerek yanıtın geldiğini doğrulayın.

Yanıt geldiyse sembol listesini inceleyin ve hangi kalemleri kullanacağınıza karar verin. Gereksiz sembolleri işlemek boşuna kaynak tüketir.

HTTP durum kodunu kontrol etmeyi ihmal etmeyin: 200 dışındaki her yanıt farklı bir davranış gerektirir.

Adım 3: Veriyi ayrıştırma ve saklama

Gelen JSON'u doğrudan kullanmak yerine kendi iç modelinize dönüştürün. Böylece kaynak şeması değişse bile uygulamanızın geri kalanı etkilenmez.

Fiyatı sayısal tipte saklayın, string olarak değil. Ondalık hassasiyeti için uygun tip seçin.

Her güncellemede son değeri ve zaman damgasını birlikte kaydedin; kesinti anında bu kopya işinizi görür.

Adım 4: Önbellek ve zamanlayıcı

Her kullanıcı isteğinde API'ye gitmeyin. Sunucunuzda çalışan bir zamanlayıcı belirli aralıkla fiyatı çeksin, uygulama o kopyayı okusun.

Bu yaklaşım hem kotanızı korur hem sayfa açılış süresini kısaltır. Kullanıcı fiyatı beklemez, hazır bulur.

Zamanlayıcı çalışmazsa fark edin: son güncelleme zamanı belirlediğiniz eşiği aşınca uyarı üretin.

Adım 5: Hata senaryolarını denemek

Entegrasyonu bitirdikten sonra bilerek bozun. API adresini yanlış yazın, anahtarı boşaltın, ağı kesin. Uygulamanız her durumda anlamlı davranmalı.

429 (kota aşımı) geldiğinde ne oluyor? Ekranda ne görünüyor? Bu soruların cevabı 'bilmiyorum' ise entegrasyon üretime hazır değildir.

Test senaryolarını yazılı tutun; sonraki geliştirmede aynı kontrolleri tekrarlarsınız.

Sık sorulan sorular

API anahtarı almak ücretli mi?

Başlangıç için ücretsiz bir plan sunulur. Üretim trafiği ve yüksek istek hacmi için ücretli planlara geçilir.

İlk isteği nasıl test ederim?

Terminalden curl ile tek satırlık bir çağrı yeterlidir. Yanıt JSON olarak döner ve doğrudan okunabilir.

Fiyatı her sayfa açılışında çekmeli miyim?

Hayır. Sunucunuzda bir zamanlayıcı fiyatı periyodik çeksin, sayfalar o kopyayı okusun. Hem hızlı hem kotanıza dost.

Kota aşımında ne yapmalıyım?

429 yanıtını yakalayıp son geçerli fiyatı göstermeye devam edin ve yeniden denemeyi geciktirin. Aynı anda çok sayıda tekrar isteği durumu kötüleştirir.

Veriyi veritabanına mı yoksa belleğe mi almalıyım?

Kısa ömürlü fiyat için bellek içi önbellek (Redis vb.) yeterlidir. Geçmiş analizi yapacaksanız ayrıca veritabanına tarihçe yazı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