Tüm Rehber Sayfaları
Marka
Has Fiyat / altinapi Başlangıç ve Kullanım Rehberi

Has Fiyat / altinapi Başlangıç ve Kullanım Rehberi

Has Fiyat altın API'sine başlarken API key oluşturmadan ilk isteğe, panelden planlara kadar tüm ilk adımları bu rehberde bulun.

Kısa cevap: Panelden bir API key oluşturur ve dokümantasyondaki uç noktaya bağlanırsınız; IP adresi eklemeniz gerekmez. Normalize şema sayesinde ilk isteği dakikalar içinde atabilirsiniz.

Has Fiyat / altinapi Nedir

altinapi.hasfiyat.com, Türkiye altın ve döviz piyasası için canlı veri sağlayan bir API servisidir. Gram altından sarrafiyeye, USD/TL'den ons altına kadar geniş bir enstrüman yelpazesini tek çatı altında sunar. REST API, Socket.IO tabanlı WebSocket ve webhook gibi farklı erişim yöntemleriyle çeşitli senaryoları destekler. Böylece kuyumcudan e-ticarete, mobil uygulamadan finans panosuna kadar birçok proje bu veriden beslenir.

Servisin ayırt edici yönleri canlı veri, çoklu kaynak güvenilirliği ve normalize tek şema tutarlılığıdır. Kaynak önceliği ve otomatik yük devretme, bir kaynak sorun yaşasa bile veriyi kesintisiz tutar. Panel üzerinden API key yönetimi, erişimi güvenli kılar. Bu bileşenler bir araya geldiğinde üretime hazır, sağlam bir veri altyapısı oluşur.

İlk Adım: API Key Oluşturma

Entegrasyona başlamanın ilk adımı, panelden bir API key oluşturmaktır. Bu anahtar, servise gönderdiğiniz tüm istekleri kimliklendirir ve size özel erişimi sağlar. Panelde farklı projeler ya da ortamlar için ayrı anahtarlar oluşturabilirsiniz; bu, test ve canlı ortamlarını birbirinden ayırmayı kolaylaştırır. Bir anahtarı iptal etmek ilgili erişimi anında keser, böylece kontrol her zaman sizde kalır.

API key'i güvenli saklamak kritik önemdedir; anahtarı koda gömmek yerine ortam değişkeni ya da güvenli yapılandırmada tutmalısınız. Böylece kaynak kodunuz paylaşılsa bile anahtarınız açığa çıkmaz. Frontend senaryolarında anahtarı doğrudan tarayıcıda kullanmak yerine kendi backend'iniz üzerinden geçirmelisiniz. Bu disiplin, verinizin yetkisiz kullanımını baştan engeller.

IP Kaydı ve Anahtar Güvenliği

Erişim API key ve aktif paketinizle doğrulanır; IP adresi eklemeniz gerekmez. Anahtarınızın kullanıldığı IP adresleri ilk istekte panelde otomatik kaydedilir, böylece anahtarın nereden kullanıldığını görürsünüz. Tanımadığınız bir adres görürseniz anahtarı panelden silip yenisini oluşturursunuz; eski anahtar yeni isteklerde anında geçersiz olur. Anahtarı yalnızca sunucu tarafında saklamak, ticari veriyi korumanın temelidir.

Paylaşımlı hostingte çıkış IP'niz değişse bile erişim kesilmez; yeni adres panelde kaydedilir. Birden fazla sunucudan erişiyorsanız tüm IP'ler aynı listede görünür. Ortam bazlı ayrı anahtarlar, test ve üretim düzenini korumanıza yardımcı olur. Böylece güvenlik, esneklikten ödün vermeden sağlanır.

Panel ve Veri Yöntemlerini Seçme

Panel, entegrasyonunuzu yönettiğiniz merkezdir; buradan API key oluşturur, anahtarınızın kullanıldığı IP'leri ve kullanım durumunuzu izlersiniz. Veriye erişim için üç yöntemden seçim yaparsınız: REST periyodik sorgu, WebSocket canlı akış, webhook olay bildirimi. Basit ve periyodik ihtiyaçlar için REST, canlı vitrin ve uygulamalar için WebSocket, reaktif senaryolar için webhook uygundur. Hepsi aynı normalize veriyle çalıştığından ihtiyaca göre birini ya da birkaçını birlikte kullanırsınız.

İlk isteği atmak için panelden anahtarınızı alır ve dokümantasyondaki uç noktaya bağlanırsınız; IP eklemeniz gerekmez. Normalize şema sayesinde gelen yanıtı ayrıştırmak dakikalar sürer. Prototipten üretime geçiş bu düşük giriş engeliyle hızlanır. Böylece fikir aşamasından canlı ürüne kısa sürede ulaşırsınız.

Planlar ve Ölçeklenme

altinapi.hasfiyat.com Starter, Pro ve Enterprise olmak üzere farklı planlar sunar; bu planlar farklı istek limitleri ve kullanım kapasiteleri sağlar. Küçük bir projeyle Starter'da başlayıp hacminiz arttıkça Pro ya da Enterprise'a geçebilirsiniz. Normalize tek şema sayesinde plan değişikliği kodunuzu etkilemez; yalnızca limitiniz genişler. Böylece büyümeniz teknik bir engele takılmadan gerçekleşir.

Her planda çoklu kaynak, otomatik yük devretme ve normalize şema gibi temel güvenceler aynıdır; planlar yalnızca kapasite bakımından farklılaşır. Bu, küçük bir vitrinden büyük bir platforma kadar tutarlı bir deneyim sunar. Doğru planı seçmek için beklenen istek hacminizi ve güncelleme sıklığınızı değerlendirmeniz yeterlidir. Böylece hem bütçenize hem ihtiyacınıza uygun bir başlangıç yaparsınız.

İlk 10 Dakika: API Key'den İlk İsteğe

Yeni başlayan biri için ilk hedef, panelden bir API key oluşturup ilk başarılı isteği almaktır; bu adım, entegrasyonun geri kalanının temelini kurar. Panele giriş yaptıktan sonra bir API key üretirsiniz; erişim için gereken tek adım budur, IP adresi eklemeniz gerekmez. İlk isteği en basit REST uç noktasına yaparak kimlik doğrulamanın doğru çalıştığını teyit edersiniz. Dönen normalize yanıtı inceleyerek gram, çeyrek gibi alanların yapısını ve zaman damgasını tanırsınız. Bu ilk tur, ileride kuracağınız daha karmaşık akışın sağlaması niteliğindedir.

İlk istek başarılı olduktan sonra, ihtiyacınıza göre iki yoldan birini seçersiniz: periyodik veri için REST ile çekme, canlı vitrin için Socket.IO akışına abone olma. Başlangıçta hataları kolay teşhis edebilmek için isteklerinizi ve dönen yanıtları loglamak faydalıdır; böylece bir sorunda nerede takıldığınızı hızlıca görürsünüz. API key'i koda gömmek yerine ortam değişkeninde saklamak, ilk andan itibaren edinmeniz gereken iyi bir alışkanlıktır. Zaman damgasını her yanıtta kontrol etmek, gösterdiğiniz verinin güncelliğinden emin olmanızı sağlar. Bu ilk on dakikayı sağlam kurduğunuzda, kaynak önceliği ve yük devretme gibi gelişmiş özellikler üzerine güvenle inşa edersiniz.

Sık sorulan sorular

altinapi'ye nasıl başlarım?

Panelden bir API key oluşturur ve dokümantasyondaki uç noktaya bağlanırsınız; IP adresi eklemeniz gerekmez. Normalize şema sayesinde ilk isteği dakikalar içinde atabilirsiniz.

API key nasıl oluşturulur?

Panelden yeni bir anahtar oluşturursunuz; her proje ya da ortam için ayrı anahtar tanımlayabilirsiniz. Anahtarı güvenli bir yapılandırmada saklamalı, koda gömmemelisiniz.

IP listesi ne işe yarar, zorunlu mu?

Zorunlu değildir; erişim API anahtarınız ve aktif paketinizle doğrulanır. Liste, anahtarınızın hangi IP adreslerinden kullanıldığını gösterir; adresler ilk istekte otomatik eklenir. Tanımadığınız bir adres görürseniz anahtarı panelden silip yenisini oluşturabilirsiniz.

Hangi veri erişim yöntemini seçmeliyim?

Periyodik ihtiyaçlar için REST, canlı akış için WebSocket, reaktif bildirim için webhook seçilir. Hepsi aynı normalize veriyle çalışır, birlikte de kullanılabilir.

Planlar arasındaki fark nedir?

Starter, Pro ve Enterprise planları farklı istek limitleri ve kapasiteler sunar. Çoklu kaynak, otomatik yük devretme ve normalize şema her planda aynıdır; planlar yalnızca kapasitede farklılaşır.

Plan yükseltince kodumu değiştirmem gerekir mi?

Hayır. Normalize tek şema sayesinde plan değişikliği kodunuzu etkilemez; yalnızca istek limitiniz genişler ve aynı entegrasyonla devam edersiniz. Alan adları, sembol kodları ve alış-satış yapısı planlar arasında birebir aynı kalır.

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.