Geçmiş ve arşiv

Başlangıç ve kimlik doğrulama Şehirler Namaz vakitleri Finans Hava durumu Puan durumu Fikstür Dünya yerleşim verisi Geçmiş ve arşiv

Zaman serileri ve her çekimin tam JSON kopyası.

Erişimanahtar gerekliküme adı: küme bazlı

Uç noktalar6aşağıda tek tek açıklanır

KaynakServisin kendi arşivi

TazelemeHer çekimdebir arşiv kaydı

Her tazelemede iki şey yazılır: kümenin tam JSON kopyası (sıkıştırılmış) ve grafiğe uygun özet satırlar. Birincisine /v1/arsiv, ikincisine ilgili kümenin /gecmis ucundan erişilir.

Geçmiş uçları kümenin kendi belgelerinde de anlatılır; burası hepsinin bir arada listesidir.

Uç noktalar

GET/v1/finans/gecmis

Kalem bazlı zaman serisi: seri[] → zaman, deger, degisim.

GET/v1/namaz/{il}/gecmis

Geçmiş günlerin vakitleri: gunler[].

GET/v1/hava/{il}/gecmis

Saatlik geçmiş ölçümler: olcumler[].

GET/v1/puan-durumu/{lig}/gecmis

O tarihteki puan tablosu.

GET/v1/arsiv/{küme}

Anlık kopyaların listesi, sayfa başına 50 kayıt.

GET/v1/arsiv/{küme}/{id}

O anın tam JSON kaydı, alındığı biçimde.

Parametreler

Parametre	Yer	Açıklama
`gun`	sorgu	Kaç günlük geçmiş. Finans ve namazda varsayılan `30` / en çok `3650`; havada varsayılan `7` / en çok `365`.
`kod`	sorgu	Finans geçmişinde kalem kodu. Varsayılan `DOLAR`.
`tarih`	sorgu	Puan geçmişinde `YYYY-AA-GG`.
`sayfa`	sorgu	Arşiv listesinde sayfa numarası (50'şer kayıt). Varsayılan `1`.

Alanlar

Arşiv listesi · kayitlar[]

Alan	Tip	Açıklama
`id`	int	Kayıt kimliği; tam JSON'u çekmek için kullanılır.
`kume`	string	Kaydın kümesi.
`alindi_at`	string	Kaydın alındığı an.
`kayit`	int	O anda kaç veri satırı vardı (il, kalem, lig…).
`boyut`	int	Ham JSON boyutu, bayt.
`gz`	int	Sıkıştırılmış boyut, bayt.

Tam kayıt (`/{id}`)

Alan	Tip	Açıklama
`(gövde)`	JSON	Zarf yoktur: o anki kümenin ham JSON'u doğrudan döner.
`X-Arsiv-Alindi`	başlık	Kaydın alındığı an yanıt başlığında bulunur.

Örnek yanıt

Örnek yanıt · /v1/finans/gecmis?kod=DOLAR&gun=3

{
  "ok": true,
  "kume": "finans",
  "kod": "DOLAR",
  "gun": 3,
  "adet": 69,
  "seri": [
    { "zaman": "2026-09-27 18:35:01", "deger": 48.93, "degisim": 0.12 },
    { "zaman": "2026-09-27 19:35:02", "deger": 48.93, "degisim": 0.12 },
    … 69 nokta
  ]
}

Kullanım

curl

curl -H "X-Api-Key: ss_…" \
  "https://api.sanater.com/v1/finans/gecmis?kod=EURO&gun=90"

PHP · seriyi CSV'ye dök

$u = 'https://api.sanater.com/v1/finans/gecmis?kod=DOLAR&gun=90&anahtar=ss_…';
$veri = json_decode(file_get_contents($u), true);

$f = fopen('dolar.csv', 'w');
fputcsv($f, ['zaman', 'deger']);
foreach ($veri['seri'] as $n) {
    fputcsv($f, [$n['zaman'], $n['deger']]);
}
fclose($f);

Bilinmesi gerekenler

Arşiv yalnız servisin çalışmaya başladığı tarihten sonrasını kapsar; daha eski bir tarih istendiğinde boş sonuç döner, hata değil.
Geçmiş uçları da anahtar ister ve isteğin kümesi hangi veriye baktığınızsa odur: /v1/hava/konya/gecmis hava kümesine sayılır.
Tam kayıt ucu arşivdeki JSON'u olduğu gibi döndürür; o günün alan adları bugünkünden farklı olabilir.

← Tüm belgeler Ücretsiz anahtar alın