Ana Sayfa / SSS

Sık Sorulan Sorular

Kapsam, teknik detaylar, kota, faturalama ve hukuki konular hakkında merak edilenler.

Genel

Türkiye ve dünya piyasalarına ait 15 farklı veri setini tek bir REST API çatısı altında sunuyoruz: döviz, emtia, faiz, kripto, ABD hisseleri, endeksler, ekonomik takvim, akaryakıt, hal, tarımsal ürün, sıfır araç, resmi tatil/iş günü, mevzuat değişiklikleri ve Resmi Gazete özeti. Hepsi aynı anahtar, aynı yanıt şeması ve aynı kredi havuzunu kullanır.

Her servisin kaynakları o API'nin künye satırında listelidir. Kamu kurumları (TCMB EVDS, EPDK, Resmi Gazete, ECB, FRED) adıyla anılır. Borsa ve ticari vendor ancak yazılı lisans sonrası bağlanır; site kazıması yapılmaz. Veriyi normalize eder, doğrular ve tutarlı bir şemaya dönüştürürüz.

Servise göre değişir: TCMB kurları günlük bülten sonrası, akaryakıt EPDK bildirimine göre günlük, hal ve tarım seans/bülten sonrası, Resmi Gazete her sabah. Anlık borsa/kripto ancak lisanslı feed ile açılır. Her API sayfasında güncelleme sıklığı yazar ve her yanıtta updatedAt alanı bulunur.

Kısmen. TCMB kur ve faiz serileri, EPDK akaryakıt, Resmi Gazete ve resmi tatil Türkiye odaklıdır. Fed, ECB ve (lisans sonrası) küresel piyasa setleri ayrı modüllerdir. Resmi tatil API'si kanun ve RG kararlarından türetilir.

Teknik

API anahtarınızı Authorization: apikey APIBIR-… başlığında gönderirsiniz. OAuth ya da imzalı istek gerekmez. Panelden birden fazla anahtar üretip her birine IP ve domain kısıtı tanımlayabilirsiniz.

Gizli anahtarı hayır — tarayıcıya gömülen anahtar herkes tarafından okunabilir. İki güvenli yol var: kendi backend'inizde bir proxy uç noktası açmak veya panelden domain kısıtlı bir public token üretmek. AI & Dashboard sayfasında hazır proxy kodu bulabilirsiniz.

Varsayılan JSON'dur. Tablo döndüren uçlarda ?format=csv parametresi desteklenir. XML desteklenmemektedir.

page ve limit parametreleriyle. Varsayılan 100, üst sınır 500 kayıttır. meta.hasNext ve meta.nextPage alanları bir sonraki sayfaya yol gösterir.

Ekonomik takvim, mevzuat değişiklikleri ve Resmi Gazete servislerinde var. Geliştirici planında 3, Profesyonel ve üzerinde sınırsız abonelik kurabilirsiniz. Her teslimat HMAC-SHA256 ile imzalanır.

Birincil bölge İstanbul, yedek bölge Frankfurt. Edge önbellek katmanı sayesinde Türkiye içinden ortalama yanıt süresi 78 ms'dir.

Kota & faturalama

Bir kredi, bir standart okuma isteğine karşılık gelir. Uzun zaman serileri ve tam metin aramalar daha fazla kredi harcar; her yanıtın creditsUsed alanında ne kadar harcandığı yazar. Hatalı istekler ve 304 Not Modified yanıtları kredi düşürmez.

Evet, 402 insufficient_credits hatası döner. Habersiz ek ücret yansıtılmaz. Panelden anında plan yükseltmesi yapabilirsiniz.

Hayır. Aylık planlar istediğiniz zaman iptal edilebilir. Yıllık ödemede iki ay bedava avantajı vardır.

Evet, her ödeme için e-arşiv fatura otomatik olarak gönderilir. Kurumsal planlarda cari hesap ve vadeli fatura düzenlenebilir.

Üniversite öğrencileri ve akademisyenler için indirim sorgulamak için bize yazın.

Hizmet seviyesi

Son 12 ayda gerçekleşen çalışma süresi %99,95'tir. Profesyonel planda %99,9, Kurumsal planda %99,95 SLA sözleşmeye eklenir; ihlal halinde kredi iadesi uygulanır.

Son başarılı yanıt önbellekte tutulur ve meta.stale: true işaretiyle döndürülür. Böylece uygulamanız boş ekran göstermez. Tamamen erişilemez durumda 503 upstream_unavailable döner.

Ücretsiz planda topluluk forumu, Geliştirici planında e-posta (1 iş günü), Profesyonel planda öncelikli destek (4 saat), Kurumsal planda adanmış teknik hesap yöneticisi. Teknik hatalarda requestId paylaşmanız çözümü hızlandırır.

Bize yazın. Talep gören veri setlerini kataloğa ekliyoruz; kurumsal müşteriler için özel uç nokta ve veri seti geliştirmesi de yapıyoruz.

Hukuki

Evet, kendi ürününüzde kullanabilirsiniz. TCMB EVDS ve benzeri kamu kaynaklarında künyede belirtilen atıf gerekir. Ham veriyi başka bir veri API'si olarak yeniden satmak hem apibir hem de yukarı kaynak şartlarına aykırı olabilir.

Hayır. apibir yalnızca kamuya açık ekonomik, kamusal ve piyasa verilerini sunar; kişisel veri içermez. Hesabınıza ait bilgiler (e-posta, fatura) KVKK ve GDPR uyumlu şekilde işlenir ve üçüncü taraflarla pazarlama amacıyla paylaşılmaz.

Ürününüzün bir parçası olarak son kullanıcıya sunmanız serbesttir. Ancak ham veriyi toplu halde başka bir veri servisi olarak yeniden satmak veya dağıtmak kullanım koşullarına aykırıdır. Bu tür bir ihtiyaç için Kurumsal lisans görüşmesi yapabiliriz.

Cevabını bulamadınız mı? İletişim formundan yazın, genellikle aynı gün içinde dönüyoruz. Teknik konular için dokümantasyona da göz atabilirsiniz.

Ücretsiz API anahtarınızı 30 saniyede alın

Kredi kartı istemiyoruz. Ücretsiz plan tüm API'leri kapsar; yalnızca aylık kredi limiti farklıdır.