Şahap API
Şahap, soket tabanlı hızlı güncellemeleriyle anlık altın fiyat takibine uygun güvenilir bir kaynaktır.
Şahap, soket tabanlı hızlı güncellemeleriyle anlık altın fiyat takibine uygun güvenilir bir kaynaktır. Hasfiyat, Şahap fiyat akışını Socket.IO ve REST üzerinden tek tutarlı şemayla dağıtır. HAS altın, gram altın, 22 ayar, çeyrek, yarım, tam ve ATA altın ile gram bazlı katları akar; dilediğiniz an REST ile de sorgulayabilirsiniz. Şahap verisini diğer kaynaklarla aynı API üzerinden birleştirerek panelinizde, TV ekranlarınızda ve pazaryerlerinizde tek noktadan, kesintisiz yönetirsiniz.
GET /v1/prices?source=sahap-api
Authorization: Bearer API_KEY
// Canlı akış
socket.on('prices:sahap-api', (d) => {
console.log(d.symbol, d.buy, d.sell)
})Şahap API ile neler yapabilirsiniz?
REST API
Anlık fiyat sorgusu için basit ve hızlı REST uç noktaları.
Socket.IO
Kesintisiz canlı akışla milisaniye gecikmeli güncelleme.
Kaynak Önceliği
Birincil kaynak yanıt vermezse otomatik yük devretme.
IP Whitelist & API Key
Tek panelden güvenli, yetkilendirilmiş erişim.
Şahap hangi verileri sunar?
HAS altın ve gram altın 22 ayar, çeyrek, yarım, tam ve ATA altın Gram bazlı katlar ve bilezik fiyatları Ons altın (XAU) Soket tabanlı canlı alış / satış akışı
Şahap soket akışı
Şahap, soket tabanlı çalışan ve güncellemeleri hızlı ileten kaynaklardandır. Hasfiyat bu akışı doğrudan dinler ve normalize ederek dağıtır.
Soket tabanlı kaynaklarda aradaki katmanın gecikme eklememesi kritiktir; veri geldiği anda işlenip bağlı istemcilere iletilir.
Kapsanan altın türleri
Has altın, gram altın ve 22 ayar başta olmak üzere çeyrek, yarım, tam ve ATA altın akışta yer alır.
Gram bazlı katlar da hesaplanabilir biçimde döndüğü için, ürün gramajıyla doğrudan çarpım yapan sistemler için uygundur.
Has altın üzerinden çalışan işletmeler
Toptan tarafta fiyatlamanın has altın üzerinden yapılması yaygındır. Bu durumda has fiyatının tazeliği doğrudan kâr marjını etkiler.
Canlı akış, has fiyatındaki her değişimi anında ilettiği için sorgu aralığından kaynaklanan gecikme ortadan kalkar.
Yedeklilik ve tazelik
Şahap'ı birincil ya da yedek kaynak olarak konumlandırabilirsiniz. Verinin yaşı tazelik penceresini aştığında geçiş otomatiktir.
Geri dönüş için kesintisiz tazelik aranır; bu asimetrik eşik, kaynaklar arasında salınımı ve ekranda fiyat zıplamasını engeller.
REST ile birlikte kullanım
Canlı akışın yanında REST ile anlık sorgu da yapabilirsiniz. Doğrulama, raporlama ve toplu işlemler için REST pratiktir.
İki yöntem aynı şemayı döndürür ve tek panelden yönetilir.
Güvenlik
API anahtarı ile kimlik doğrulanır; IP veya alan adı yetkilendirmesiyle erişim sınırlanır ve trafik şifreli taşınır.
Kota ve yetkili adresler panelden anlık yönetilir.
Has altın üzerinden çalışan işletmelerin ihtiyacı
Toptan ve imalat tarafında fiyatlama has altın üzerinden yapılır ve marjlar dardır. Bu yapıda has fiyatının tazeliği doğrudan kâra yansır.
Soket tabanlı akış, has fiyatındaki her değişimi anında ilettiği için sorgu aralığından kaynaklanan kör noktayı ortadan kaldırır. Periyodik sorgulamada bu kör nokta, sorgu aralığınız kadardır.
Gram bazlı katların hesaplanması
Ürün fiyatı çoğunlukla gramaj ile birim fiyatın çarpımıdır. Verinin gram bazında ve tutarlı bir şemada gelmesi, bu çarpımı doğrudan yapabilmenizi sağlar.
Ayar farkları için ayrı semboller bulunur; 22 ayar ile 14 ayar ürün kendi emtiasının fiyatına bağlanır. Tek bir altın fiyatı üzerinden çalışmak, ayarlar arasındaki farkı görmezden gelmek anlamına gelirdi.
Dar marjlı işlerde veri tazeliği
Marj daraldıkça verinin tazeliği kâr üzerinde orantısız bir etki kazanır. Yüzde birlik marjla çalışan bir işlemde saniyelerin maliyeti hissedilir.
Sürekli açık bir bağlantı, sorgu aralığından kaynaklanan kör noktayı ortadan kaldırır. Bu, dar marjlı toptan işlerde en çok fark yaratan tek ayrıntıdır.
Soket bağlantısını sağlıklı tutmak
Sürekli açık bir bağlantı kullanan uygulamalarda en sık gözden kaçan konu, ağ kesintisinden sonra yeniden bağlanma davranışıdır. İstemci kütüphanesinin otomatik yeniden bağlanma özelliğini açık bırakmak çoğu durumda yeterlidir.
Yeniden bağlandığında son fiyatlar hemen iletilir; kullanıcı boş ekran görmez. Mobil uygulamalarda uygulama arka plana geçtiğinde bağlantıyı kapatıp öne geldiğinde yeniden açmak yaygın ve önerilen bir yaklaşımdır.
Sunucu taraflı entegrasyonlarda ise bağlantıyı sürekli açık tutmak ve gelen veriyi kendi önbelleğinize yazmak, iç servislerinizin tek noktadan beslenmesini sağlar.
Sık sorulan sorular
Şahap API soket akışı sunuyor mu?
Evet. Şahap soket tabanlıdır; Socket.IO ile HAS, gram ve 22 ayar fiyatlarını canlı alırsınız.
Şahap hangi altın türlerini kapsar?
HAS, gram, 22 ayar, çeyrek, yarım, tam, ATA altın ve gram bazlı katları kapsar.
REST ile de erişebilir miyim?
Evet, canlı akışın yanında REST ile anlık sorgu da yapabilirsiniz.
Şahap canlı akış sunuyor mu?
Evet. Soket tabanlıdır; Socket.IO ile fiyatları anlık alırsınız.
Has altın üzerinden fiyatlama yapabilir miyim?
Evet. Has altın akışta yer alır ve gram bazlı katlar hesaplanabilir biçimde döner.
Şahap altın API'si nedir?
Şahap altın API'si, Hasfiyat'ın entegre ettiği veri kaynaklarından biridir ve altın, sarrafiye ile döviz fiyatlarını REST, WebSocket ve webhook üzerinden sunar. Geliştiriciler bu kaynağı tek API anahtarıyla güncel altın ve kur verisi almak için kullanır.
Şahap kaynağından güncel gram altın fiyatı nasıl alınır?
Şahap kaynağından güncel gram altın fiyatını almak için gram sembolünü belirtip REST uç noktasına Authorization header ile istek gönderirsiniz. Yanıtta gram altının alış ve satış değerleri ayrı JSON alanlarında döner.
Şahap API hangi verileri kapsıyor?
Şahap API'si gram ve has altın, çeyrek, yarım, tam, ata, cumhuriyet, reşat gibi sarrafiye ürünleri ile ons, gümüş ve döviz paritelerini kapsar. Toplam 67'den fazla sembol aynı kaynaktan sorgulanabilir.
Şahap fiyatları anlık olarak mı güncelleniyor?
Evet, Şahap fiyatları kaynaktan geldiği anda güncellenir ve değişiklikler WebSocket üzerinden anında iletilir. Bu sayede uygulamanız piyasayı neredeyse gerçek zamanlı yansıtır.
Şahap veri kaynağı güvenilir mi?
Şahap, Hasfiyat'ın çoklu kaynak mimarisinde güvenilir bir sağlayıcıdır ve yanıt vermediğinde diğer kaynaklardan otomatik fiyat üretilir. Bu failover yapısı tek kaynağa bağımlılığı ortadan kaldırır.
Şahap fiyat doğruluğu nasıl sağlanır?
Şahap'tan gelen alış satış fiyatları Hasfiyat tarafında diğer kaynaklarla çapraz doğrulanır ve aykırı değerler ayıklanır. Bu denetim fiyat verisinin doğruluğunu güvence altına alır.
Şahap geçmiş fiyat verisi sunuyor mu?
Evet, Şahap kaynağının geçmiş fiyatlarına tarih aralığı belirterek Hasfiyat API'si üzerinden erişebilirsiniz. Bu tarihsel veri altın grafikleri ve geçmiş dönem karşılaştırmaları için kullanılır.
Şahap WebSocket ile canlı veri veriyor mu?
Evet, Şahap fiyatlarını Socket.IO tabanlı WebSocket bağlantısıyla canlı olarak dinleyebilirsiniz. Fiyat her değiştiğinde sunucu size anında olay göndererek sürekli sorgu ihtiyacını kaldırır.
Şahap'ta alış ve satış fiyatı ayrı mı?
Evet, Şahap her sembol için alış (buy) ve satış (sell) fiyatlarını ayrı alanlarda döndürür. Bu ayrım sarraf ve kuyumcu uygulamalarında doğru kur gösterimi için gereklidir.
Şahap kaynağı çökerse fiyat nereden gelir?
Şahap kaynağı çökerse Hasfiyat aynı sembol için diğer kaynaklardan fiyat sağlayarak kesintiyi önler. Bu failover geçişi otomatik gerçekleşir ve manuel müdahale gerektirmez.
Şahap API kimlik doğrulaması nasıl yapılır?
Şahap API'sine gönderdiğiniz her istekte API anahtarınızı Authorization header ile iletmeniz gerekir. Anahtar doğrulanmadığında istek yetkisiz sayılır ve fiyat dönmez.
Python ile Şahap WebSocket'e nasıl bağlanılır?
Python'da Şahap canlı fiyatlarına bağlanmak için python-socketio istemcisini kullanır ve bağlantı sırasında API anahtarınızı iletirsiniz. Bağlantı kurulduğunda fiyat değişimleri olay olarak akmaya başlar.
Şahap ile USD/EUR çapraz parite alınır mı?
Evet, Şahap kaynağı USD, EUR ve GBP çapraz pariteleri ile serbest piyasa alış satış kurlarını sunar. Kripto ve BIST verileri ise Hasfiyat kapsamı dışındadır.
Şahap kaynağını diğer kaynaklarla neden karşılaştırmalıyım?
Şahap kaynağını diğer kaynaklarla karşılaştırmak, fiyat farklarını görmenizi ve uygulamanız için en uygun referansı seçmenizi sağlar. Hasfiyat'ın çoklu kaynak yapısı bu karşılaştırmayı tek API üzerinden mümkün kılar.
Şahap API ile hemen entegre olun
Dakikalar içinde REST veya Socket.IO ile canlı veriye bağlanın.