API Dökümantasyonu

Genel Bakış

makrometrik API, Türkiye makroekonomik verilerine programlı, salt-okunur erişim sağlar. Tüm uç noktalar JSON döner (CSV uç noktası hariç) ve resmi kaynaklardan (TCMB EVDS, TÜİK) derlenir.

Temel adres tüm istekler için aynıdır:

https://api.makrometrik.com/api/v1

Kimlik Doğrulama

API anahtarı isteğe bağlıdır (veri API'si şu an açıktır). Anahtarınız varsa, Authorization başlığında Bearer şeması ile gönderin; istekler anahtarınıza atfedilir.

curl -H "Authorization: Bearer ms_live_xxx" \
  https://api.makrometrik.com/api/v1/series/dolar-tl/latest

Anahtarınızı Hesap → API Anahtarları sayfasından oluşturun. Tam anahtar yalnızca bir kez gösterilir.

Pano özeti (öne çıkanlar + sparkline)

Öne çıkan göstergeler ve her biri için son 24 noktalık sparkline — ana sayfayı besleyen tek çağrı.

GET https://api.makrometrik.com/api/v1/dashboard/summary

Sağlık & tazelik durumu

Servisin durumu, indekslenen/veri içeren seri sayısı, kaynak bazında son başarılı güncelleme zamanı ve zamanlayıcı durumu.

GET https://api.makrometrik.com/api/v1/health

Seri kataloğu (arama + süzme)

Seri kataloğunu listeler/arar (sayfalı: `limit`/`offset`). `q` ad/kod araması, `domain` ve `relevance` ile süzme, `has_data` yalnız veri içerenler, `curated` yalnız öne çıkanlar. Eşleşen toplam kayıt sayısı `X-Total-Count` yanıt başlığında döner (sayfalama için).

GET https://api.makrometrik.com/api/v1/series

• —q (query): Ad/kod araması
• —category (query): EVDS kategori kimliği
• —domain (query): Alan süzgeci: markets_rates | banking_credit | external_bop | prices_expect | non_financial
• —relevance (query): Yatırımcı ilgisi süzgeci: financial | investment_relevant | other
• —has_data (query): Yalnızca gözlemi olan seriler
• —curated (query): Yalnızca öne çıkan (curated) seriler
• —limit (query): Sayfa başına (en çok 1000)
• —offset (query): Atlanacak kayıt

Seri detayı + gözlemler

Bir serinin meta verisi ve gözlem dizisi. `slug` (örn. `dolar-tl`) veya ham EVDS kodu (örn. `TP.DK.USD.A.YTL`) ile erişilir. `from`/`to` (YYYY-AA-GG) ile tarih aralığı süzülür.

GET https://api.makrometrik.com/api/v1/series/{slug_or_code}

• —slug_or_code (path) — zorunlu
• —from (query): Başlangıç tarihi (YYYY-AA-GG)
• —to (query): Bitiş tarihi (YYYY-AA-GG)

Seriyi CSV indir

Seriyi CSV olarak indirir (`tarih,deger` başlığı, Excel için UTF-8 BOM). Her gerçek indirme, serinin herkese açık indirme sayacını atomik olarak bir artırır.

GET https://api.makrometrik.com/api/v1/series/{slug_or_code}/csv

• —slug_or_code (path) — zorunlu

Serinin son değeri

Bir serinin yalnızca en güncel gözlemi (ve bir önceki) — panolar/özet için hafif uç nokta.

GET https://api.makrometrik.com/api/v1/series/{slug_or_code}/latest

• —slug_or_code (path) — zorunlu

Hatalar ve Limitler

• —404 — seri bulunamadı (series_not_found).
• —422 — geçersiz parametre (ör. hatalı tarih biçimi).
• —Yanıtlar Cache-Control + ETag taşır; veri en çok günde bir değişir.