Altın fiyat API'si tam olarak neyi çözer?
Altın fiyatı gün içinde saniyeler mertebesinde değişir. Bir e-ticaret sitesinde ürün fiyatını sabit tutarsanız ya zarar edersiniz ya da müşteri kaybedersiniz. Altın fiyat API'si bu sorunu, fiyatı kaynağından alıp sisteminize taşıyarak çözer.
Manuel güncelleme yapan bir işletmede fiyat ortalama 15-30 dakika gecikmeli kalır. Volatil bir günde bu gecikme gram başına ciddi bir fark demektir. API kullanıldığında gecikme saniyelere iner ve insan hatası ortadan kalkar.
Hasfiyat API; gram altın, has altın, ons, çeyrek, yarım, tam, ata, reşat gibi ziynet kalemleri ile USD/TRY, EUR/TRY paritelerini tek bir uçtan sunar. Kaynak seçilebilir, böylece kendi piyasanıza uygun fiyatı alırsınız.
Uç noktalar ve temel istek yapısı
Temel uç `GET /api/prices` şeklindedir ve tüm sembolleri tek çağrıda döndürür. Tek bir sembol için `GET /api/prices/{sembol}` kullanılır. Kaynak belirtmek isterseniz `?source=` parametresi eklenir.
Yanıt saf JSON'dur; her kalem için alış, satış, değişim yüzdesi ve zaman damgası bulunur. Zaman damgası kritiktir: verinin ne kadar taze olduğunu ondan anlarsınız.
İstekler `Authorization` başlığında API anahtarınızla imzalanır. Anahtarı istemci tarafında (tarayıcıda) asla açığa çıkarmayın; çağrıyı kendi sunucunuzdan yapıp sonucu önbelleğe alın.
Kimlik doğrulama, plan limitleri ve kota yönetimi
Her hesaba bir API anahtarı verilir. Anahtar başına aylık istek limiti planınıza göre belirlenir. Limit aşıldığında istekler 429 yanıtı döner; bu durumu kodunuzda mutlaka ele alın.
Kota tüketimini azaltmanın en etkili yolu önbelleklemedir. Fiyatı 5-10 saniye önbellekte tutmak, çoğu senaryoda kullanıcı deneyimini bozmadan istek sayısını onda birine indirir.
Yüksek trafikli bir sitede her ziyaretçi için ayrı API çağrısı yapmayın. Sunucunuzda tek bir zamanlayıcı fiyatı çeksin, tüm ziyaretçiler o kopyayı görsün.
Hata yönetimi ve dayanıklılık
Ağ kesintisi, kaynak sitesinin yavaşlaması veya bakım gibi durumlar kaçınılmazdır. Sağlam bir entegrasyon, son başarılı fiyatı saklar ve yeni veri gelmezse eskisini göstermeye devam eder — ama kullanıcıya verinin yaşını belli eder.
Yanıttaki zaman damgasını kontrol edin. Belirlediğiniz eşiği (örneğin 15 dakika) aşan bir veri geldiyse bunu bayat kabul edip uyarı üretin. Sessizce eski fiyat göstermek, yanlış fiyattan satış yapmaktan daha tehlikelidir.
Yeniden deneme yaparken üstel geri çekilme (exponential backoff) kullanın. Hata anında saniyede onlarca istek atmak, hem kotanızı yakar hem sorunu büyütür.
REST mi WebSocket mi: hangi senaryoda hangisi?
REST, periyodik güncelleme yeten senaryolar için idealdir: ürün fiyatı güncelleme, günlük rapor, muhasebe entegrasyonu. Kurulumu basittir, her dilde birkaç satırla çalışır.
WebSocket ise fiyatın anında ekrana düşmesi gereken yerler içindir: vitrin ekranı, işlem paneli, canlı grafik. Tek bağlantı açılır, sunucu değişimi kendisi iter; sürekli sorgulama gerekmez.
Karma yaklaşım da yaygındır: kritik ekranlar WebSocket ile beslenir, arka plan işleri REST ile yürür. İkisi aynı veri kümesini kullandığı için tutarsızlık oluşmaz.
Üretime almadan önce kontrol listesi
API anahtarınız sunucu tarafında saklanıyor ve istemciye sızmıyor mu? Önbellek süresi belirlendi mi? 429 ve 5xx yanıtları için davranış tanımlı mı?
Veri yaşı kontrolü var mı, bayat veride ne oluyor? Fiyat gösterilen her yerde son güncelleme zamanı görünüyor mu?
Test ortamında düşük limitle deneyin, ardından üretim anahtarına geçin. [Dokümantasyon](/docs) sayfasında tüm uçların güncel referansını bulabilirsiniz.
Sık sorulan sorular
Altın fiyat API'si ne kadar sıklıkla güncellenir?
Veri kaynaktan saniyeler mertebesinde alınır. REST ucunda her istekte en güncel kopya döner; WebSocket kullanıyorsanız değişim anında size iletilir. Pratikte gecikme saniyenin altındadır.
Ücretsiz plan var mı, limitleri nedir?
Deneme amaçlı ücretsiz bir başlangıç planı bulunur ve aylık istek sayısı sınırlıdır. Üretim trafiği için ücretli planlara geçmek gerekir; limitler ve fiyatlar fiyatlandırma sayfasında güncel olarak yayımlanır.
Hangi sembolleri sunuyorsunuz?
Gram altın, has altın, ons altın, 22 ve 14 ayar, çeyrek, yarım, tam, ata, reşat gibi ziynet kalemleri ile USD/TRY, EUR/TRY başta olmak üzere döviz pariteleri sunulur. Sembol listesi dokümantasyonda tam haliyle yer alır.
API anahtarımı tarayıcıda kullanabilir miyim?
Kullanmayın. Tarayıcıya konan anahtar herkes tarafından görülebilir ve kotanız başkaları tarafından tüketilebilir. Çağrıyı kendi sunucunuzdan yapın, sonucu istemciye siz iletin.
Veri gelmezse ne olur?
İyi kurgulanmış bir entegrasyonda son başarılı fiyat saklanır ve gösterilmeye devam eder; ancak yanıttaki zaman damgası kontrol edilerek verinin bayatladığı kullanıcıya bildirilir. Sessizce eski fiyat göstermek önerilmez.
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.