Node.js ile Canlı Altın Fiyatı Akışı WebSocket ile Gerçek Zamanlı Veri

Node.js 18+ ile yerleşik `fetch` kullanabilirsiniz: `await fetch(url, { headers: { Authorization: 'Bearer API_ANAHTARINIZ' } })` ardından `await res.json()` ile JSON'u okursunuz. Eski sürümlerde `node-fetch` veya `axios` tercih edilir. Anlık akış için ayrıca `ws` paketiyle (Node.js 22 ve sonrasında yerleşik `WebSocket` ile) bağlantı kurulur.

`npm install ws` ile paketi kurup `const ws = new WebSocket('wss://api.hasfiyat.com/stream?source=harem&token=API_ANAHTARINIZ')` ile bağlanın, `ws.on('message', m => { const veri = JSON.parse(m); })` ile gelen listeyi dinleyin. Bağlantı koptuğunda yeniden bağlanmayı `close` olayında kendiniz başlatırsınız. Bu yöntemle her fiyat değişiminde güncel liste size ulaşır.

`fetch(url, { headers: { Authorization: 'Bearer API_ANAHTARINIZ' } })` şeklinde header nesnesini isteğe geçirirsiniz. WebSocket tarafında ise anahtar bağlantı adresindeki `token` parametresiyle gönderilir: `wss://api.hasfiyat.com/stream?source=harem&token=API_ANAHTARINIZ`. Anahtar her istekte doğrulandığından header eksikse 401 yanıtı dönersiniz.

JSON yanıtında her sembolün alış ve satış değerleri ayrı alanlarda geldiğinden `veri.data.find(k => k.title === 'HAS ALTIN')` ile bulduğunuz kalemin `buy` ve `sell` alanlarını ayrı okursunuz. Sarrafiye uygulamalarında makas önemli olduğu için ikisini birlikte göstermek yaygındır. Değerler ilgili kaynağın anlık kotasyonunu yansıtır.

İsteği `try/catch` bloğuna alın ve `if (!res.ok) throw new Error(res.status)` ile 4xx/5xx durumlarını kontrol edin; ağ hataları zaten `catch`'e düşer. `AbortController` ile zaman aşımı ekleyerek yanıt gecikirse isteği iptal edebilirsiniz. Böylece geçersiz anahtar veya bağlantı sorunlarında uygulamanız kontrollü davranır.

Anahtarı koda yazmak yerine `.env` dosyasında saklayıp `dotenv` paketiyle `process.env.HASFIYAT_API_KEY` üzerinden okursunuz ve `.env`'i `.gitignore`'a eklersiniz. Anahtarı asla tarayıcıda çalışan istemci JavaScript'ine gömmeyin, çünkü orada herkese açık hale gelir. Sunucu tarafı Node.js kodunda tutmak en güvenli yoldur.

Bağlantıyı açan kodu bir fonksiyona alın ve `ws.on('close', () => setTimeout(baglan, bekleme))` ile kopmada yeniden çağırın; bekleme süresini her denemede iki katına çıkarıp 30 saniyeyle sınırlamak iyi bir varsayılandır. Başarılı bağlantıda (`open`) beklemeyi sıfırlarsınız. Sunucudaki çoklu-kaynak failover sayesinde ayrıca bir veri kaynağı düşse de akış devam eder.

Akış seçtiğiniz kaynağın tüm kalemlerini gönderir; belirli sembolleri istemci tarafında süzersiniz: `const istenen = new Set(['HAS ALTIN', 'USD/TL'])` tanımlayıp `veri.filter(k => istenen.has(k.title))` ile yalnızca ilgilendiğiniz kalemleri ayırırsınız. REST tarafında ise `symbols` parametresiyle sunucudan doğrudan yalnızca bu kalemleri isteyebilirsiniz.

Döviz kurları aynı REST uç noktasından döner; harem kaynağında `USD/TL` ve `EUR/TL` başlıklı kalemlerin `sell` alanlarını okursunuz. API çapraz pariteleri (USD, EUR, GBP) ve serbest piyasa alış/satış kurlarını sağlar. Kripto para ve BIST verileri bu API kapsamında değildir.

401 genellikle Authorization header'ının eksik veya anahtarın geçersiz olduğunu gösterir; header'ı `Bearer API_ANAHTARINIZ` formatında ve anahtarın aktif olduğundan emin olun. `process.env` ile okuyorsanız `dotenv` yapılandırmasının en üstte çağrıldığını ve değişkenin dolu geldiğini `console.log` ile kontrol edin. Header'ı WebSocket tarafında `extraHeaders` altında verdiğinizi doğrulayın.

Sarrafiye ürünleri ayrı sembollerle döndüğü için harem kaynağında `YENİ ÇEYREK`, `YENİ YARIM` ve `YENİ TAM` başlıklı kalemlerin alış-satış değerlerini okursunuz. API ata, cumhuriyet ve reşat çeşitlerini de kapsar. Her ürün için makası göstermek kullanıcıya değer katar.

Node 18+ ile gelen yerleşik `fetch` çoğu durumda yeterlidir ve ek bağımlılık gerektirmez; ancak `axios` otomatik JSON çözme, interceptor ve daha kolay hata yönetimi sunar. Basit GET istekleri için `fetch`, karmaşık istemci mantığı için `axios` tercih edebilirsiniz. Her iki yöntemde de Authorization header'ını aynı şekilde eklersiniz.

REST yanıtından ons altın sembolünü okuyarak `veri.data.find(k => k.title === 'ONS').sell` ile dolar bazlı XAU değerine ulaşırsınız. Bu değeri USD/TRY kuruyla çarparak gram altın çevrimi yapabilirsiniz. API 67'den fazla sembol arasında ons XAU'yu da canlı olarak sağlar.

WebSocket bağlantısını sunucu tarafı Node.js'te tutup gelen fiyatları kendi backend'inizden istemci arayüzüne WebSocket veya SSE ile iletmeniz güvenli yaklaşımdır; böylece API anahtarı tarayıcıya sızmaz. React/Vue tarafında bu iç kanalı dinleyip state'i güncellersiniz. Anahtarı asla doğrudan ön yüz koduna koymayın.

WebSocket ile aldığınız güncel altın fiyatını hesaplayıp pazaryeri API'leri üzerinden ilgili ürünün fiyatını Node.js'te güncelleyebilirsiniz. Hasfiyat Trendyol, Hepsiburada, N11, Amazon, Çiçeksepeti ve Pazarama gibi pazaryerleriyle entegrasyona uygundur. Fiyat güncellemesini olay tetiklemeli yaparak makası ve ayar bilgisini doğru sembolden aldığınızdan emin olun.

Express ile bir POST uç noktası açıp API panelinde bu URL'yi webhook olarak tanımlarsınız; fiyat olayları JSON gövdesiyle iletilir ve `req.body` ile okursunuz. Webhook, sürekli açık bağlantı yönetmek istemediğinizde WebSocket'e bir alternatiftir. Gelen isteği işlemeden önce beklenen sembol ve alan yapısını doğrulayın.

Değerli metal sembolleri REST yanıtında yer alır; gümüş, platin ve paladyum harem kaynağında `GÜMÜŞ TL`, `PLATİN ONS` ve `PALADYUM ONS` gibi başlıklarla gelir. API bu metalleri farklı kaynaklardan derleyip alış-satış olarak sunar. Kripto para bu kapsamın dışında olduğundan yalnızca fiziki metaller ve dövizler döner.

Ayar bazlı fiyatlar kaynağın kendi başlıklarıyla gelir; örneğin harem kaynağında `22 AYAR` ve `14 AYAR` kalemleri bulunur. Kaynakta bulunmayan bir ayar için has altın fiyatını milyem oranıyla çarparak kendi hesabınızı yaparsınız. Her kalem için alış ve satış ayrı döner.

`AbortController` oluşturup `setTimeout` ile belirli süre sonra `controller.abort()` çağırın ve `fetch(url, { signal: controller.signal, headers })` şeklinde sinyali geçirin. Süre dolarsa istek iptal edilir ve `catch` bloğuna düşer. Böylece yanıt gecikmesinde uygulamanız takılıp kalmaz.

WebSocket akışı kaynağın tüm sembollerini tek mesajda gönderir; birden çok sembolü takip etmek için gelen diziyi `title` alanına göre ayırmanız yeterlidir. REST tarafında ise tek GET isteğinde `symbols` parametresine virgülle birden çok sembol yazarak hepsini birlikte okuyabilirsiniz. Canlı fiyat panoları için WebSocket yaklaşımı daha akıcıdır.

Evet, sunucu tarafında kaynaklar arasında çoklu-kaynak failover çalışır; Harem, Hakan, Mayda gibi kaynaklardan biri düşerse fiyat otomatik diğerinden derlenir. Node.js istemciniz bunu fark etmeden aynı sembolden kesintisiz veri okumaya devam eder. Bu yüzden istemci tarafında ayrı kaynak yönetimi yazmanıza gerek yoktur.

Sık aralıklarla REST GET atmak aylık istek kotanızı hızla tüketir (kota dolunca 429 döner) ve her istekte gecikme ekler; oysa WebSocket bağlantısı fiyat değiştikçe size veri iter, tekrar tekrar sormanız gerekmez. WebSocket akışı REST kotasından düşmediği için hem kotayı korur hem düşük gecikme sağlar. Sürekli canlı veri gereken panolarda WebSocket tercih edin.