API Dokümantasyonu

Giriş

Hasfiyat API, kuyumcu ve döviz büroları için 11 farklı kaynaktan anlık altın, döviz ve kripto para verilerini tek bir noktada toplar. REST API ve WebSocket Stream seçenekleri ile uygulamanıza en uygun veri akışını kolayca entegre edebilirsiniz.

API isteklerinizi doğrulamak için `Authorization` başlığında API anahtarınızı (Bearer Token) kullanmanız gerekmektedir. Anahtarlarınızı panel üzerinden **Erişim Yönetimi** sayfasından oluşturabilirsiniz.

GET /api/prices HTTP/1.1
Host: api.hasfiyat.com
Authorization: Bearer YOUR_API_KEY

Tüm bot verilerine tek bir uç nokta üzerinden erişebilirsiniz. Kaynak seçimi için `source` parametresini kullanın.

const url = "https://api.hasfiyat.com/api/prices?source=harem&symbols=GRAM,HAS";
const res = await fetch(url, { headers: { 'Authorization': 'Bearer YOUR_KEY' } });
console.log(await res.json());

WebSocket teknolojisi ile verileri anlık olarak takip edin. Her veri değişikliğinde anında bildirim alırsınız.

const token = "YOUR_JWT_TOKEN";
const ws = new WebSocket("wss://api.hasfiyat.com/stream?source=harem&token=" + token);

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('Canlı Veri:', data);
};

ws.onerror = (err) => {
  console.error('Bağlantı Hatası:', err);
};

Kullanılabilir Kaynaklar

Hasfiyat paneli; altın ürün fiyatlarınızı 15 pazaryeri ve e-ticaret mağazasına canlı altın kuruna göre otomatik aktarır. Fiyatlar gramaj, emtia kaynağı ve marj oranınıza göre hesaplanır; tampon ve volatilite eşikleriyle gereksiz güncellemeler engellenir.

Desteklenen Platformlar

Fiyat Nasıl Hesaplanır?

Her ürün için gramaj ve baz emtia (HAS, GRAM, 22 ayar, çeyrek vb.) tanımlanır. Fiyat, seçtiğiniz kaynağın canlı değerinden hesaplanır; tampon (buffer) ve volatilite eşiği ile küçük dalgalanmalarda gereksiz güncelleme yapılmaz, marjınız korunur.

Senkronizasyon Modları

Kurulum Adımları

1. 1Panelde Pazaryerleri sayfasına gidin ve yeni entegrasyon ekleyin.
2. 2Pazaryerini seçip kimlik bilgilerini (API anahtarı, mağaza adresi vb.) girin ve bağlantıyı doğrulayın.
3. 3Ürünleri çekin, gramaj ve baz emtiayı eşleştirin; alış/satış marjınızı belirleyin.
4. 4Test (Dry-run) modunda fiyatları önizleyin; doğruysa Canlı moda alıp gönderim sıklığını ayarlayın.