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?
Hayır. Kayıt olduğunuzda hesabınıza 10 gün ücretsiz Pro paket tanımlanır ve API anahtarınızı hemen oluşturabilirsiniz. Bu sürede entegrasyonu baştan sona kurup sembol kapsamını doğrulayabilir, ardından hacminize uygun pakete geçebilirsiniz.
İ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. Anahtarınızı Authorization başlığında göndermeniz yeterlidir; IP adresi eklemeniz gerekmez.
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 olur. Böylece ziyaretçi sayınız arttığında API istek sayınız artmaz ve sayfa yanıt süreniz dış servise bağlı kalmaz.
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 yeterlidir. Geçmiş analizi yapacaksanız ayrıca veritabanına tarihçe yazın. İki katmanı birlikte kullanmak yaygındır: anlık gösterim önbellekten, rapor ve grafikler tarihçe tablosundan beslenir.
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.