SanaterServis API

Namaz vakitleri, finans, hava durumu, futbol ve dünya yerleşim verisi (ülke → il → ilçe) tek JSON servisinde. Zamanlanmış kümeler düzenli tazelenir; kaynak yanıt vermezse son geçerli veri bayat:true işaretiyle sunulmaya devam eder.

Ücretsiz hesap açın GirişÜcretsiz hesap: günde 1,000 istek

Servistüm kümeler güncel/v1/durum makine okunur

Veri kümeleri6namaz · finans · hava · puan · fikstür · yerler

Dünya yerleşim252 ülke3.865 il/eyalet · 47.643 ilçe

Türkiye81 ilplaka ya da slug ile

Ligler5Süper Lig, TFF 1. Lig, Premier Lig, Bundesliga, La Liga

Hızlı başlangıç

Hesap açın/hesap/kayit ile kaydolun; ilk anahtarınız anında üretilir ve bir kez gösterilir.

Anahtarı ekleyinHer isteğe X-Api-Key: ss_… başlığı ya da ?anahtar=ss_… parametresi.

Veriyi çekinJSON yanıt, CORS açık. X-RateLimit-Remaining başlığı kalan hakkı gösterir.

curl

curl -H "X-Api-Key: ss_…" https://api.sanater.com/v1/namaz/konya

PHP

$ctx = stream_context_create(["http" => ["header" => "X-Api-Key: ss_…"]]);
$veri = json_decode(file_get_contents("https://api.sanater.com/v1/finans", false, $ctx), true);

JavaScript

fetch("https://api.sanater.com/v1/hava/42", { headers: { "X-Api-Key": "ss_…" } })
  .then(r => r.json()).then(console.log);

Bölüm belgeleri

Her bölümün kendi sayfasında uçların tamamı, parametreler, alan alan yanıt açıklaması, örnek yanıt, çalışan kod parçaları ve bilinmesi gereken kısıtlar var.

Başlangıç ve kimlik doğrulamaAnahtar alma, istek gönderme, ortak yanıt zarfı, hata kodları ve önbellek kuralları.Tam kullanım →Şehirler81 ilin plakası, adı, slug'ı ve koordinatı. Anahtar gerektirmez.Tam kullanım →Namaz vakitleri81 ilin günlük altı vakti, sıradaki vakit ve kalan dakika.Tam kullanım →FinansBIST 100, Dolar, Euro ve Gram Altın; değer, günlük değişim ve yön.Tam kullanım →Hava durumu81 il için anlık ölçüm ve dört günlük tahmin; ikon kodu ve durum metniyle.Tam kullanım →Puan durumuBeş ligin puan tablosu: sıra, oynanan, averaj, puan ve son beş maçın formu.Tam kullanım →FikstürBeş ligin maç programı: hafta hafta tarih, saat, takımlar ve skor.Tam kullanım →Dünya yerleşim verisiÜlke → il/eyalet → ilçe; ad, slug, GeoNames kimliği ve Türkiye'de plaka.Tam kullanım →Geçmiş ve arşivZaman serileri ve her çekimin tam JSON kopyası.Tam kullanım →

Uç noktalar

GET/v1/sehirler açık

81 il: plaka (id), ad, slug, enlem, boylam. Anahtar gerektirmez. Tam kullanım →

GET/v1/namaz/{il}

Günün altı vakti, sıradaki vakit ve kalan dakika. {il} plaka ya da slug; /v1/namaz tüm iller. Tam kullanım →

GET/v1/finans

BIST 100, Dolar, Euro, Gram Altın: değer, günlük değişim yüzdesi, yön. /v1/finans/{kod} tek kalem. Tam kullanım →

GET/v1/hava/{il}

Anlık sıcaklık, hissedilen, nem, rüzgâr, görüş, durum metni ve ikon kodu; 4 günlük en düşük/en yüksek. /v1/hava tüm iller. Tam kullanım →

GET/v1/puan-durumu/{lig}

Puan tablosu; form sütunu son 5 maç (G/B/M), takım logoları bu sunucudan. /v1/puan-durumu lig listesi. Tam kullanım →

GET/v1/fikstur/{lig}

Güncel haftanın maçları; ?hafta=5 belirli hafta, ?hafta=tum tüm sezon. Tam kullanım →

GET/v1/…/gecmis

Arşivden geçmiş: /v1/finans/gecmis?kod=DOLAR&gun=30, /v1/namaz/{il}/gecmis?gun=30, /v1/hava/{il}/gecmis?gun=7, /v1/puan-durumu/{lig}/gecmis?tarih=2026-09-01. Tam kullanım →

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

Anlık kopya listesi ve o anın tam JSON kaydı (/v1/arsiv/{küme}/{id}). Tam kullanım →

GET/v1/yerler/{ulke}[/{il}]

Dünya yerleşim verisi: 252 ülke, 3.865 il/eyalet, 47.643 ilçe. Ülke listesi, iller, ilçeler ve ad araması. Kaynak: GeoNames (CC BY 4.0). Tam kullanım →

GET/v1/durum açık

Sağlık: her kümenin yaşı ve bayatlık durumu; biri bayatsa HTTP 503. Anahtar gerektirmez. Tam kullanım →

Kimlik doğrulama ve limitler

/v1/durum ve /v1/sehirler dışındaki uçlar API anahtarı ister. Anahtarsız ya da tanınmayan anahtar 401, iptal edilmiş anahtar / askıdaki hesap / yetkisiz küme 403, günlük limit aşımı 429 döner. Limit her gece 00:00 (Türkiye) sıfırlanır; hesap panelinden anahtar başına küme kısıtı tanımlanabilir.

Yanıt zarfı

Her yanıt ok, kume, kaynak, guncelleme (ISO 8601, Türkiye saati), yas_sn ve bayat alanlarını taşır. Yanıtlar ETag taşır; If-None-Match gönderen istemci değişmeyen veri için 304 alır. Hava ikon kodları: 1/33 açık, 2/34 parçalı bulutlu, 3 bulutlu, 4 kapalı, 5 yağmur, 6 çisenti, 7 kar, 8 sis, 9 fırtına (33/34 gece).

Örnek yanıt · /v1/finans/DOLAR

{
  "ok": true,
  "kume": "finans",
  "kaynak": "haber7",
  "guncelleme": "2026-09-11T11:00:03+03:00",
  "yas_sn": 412,
  "bayat": false,
  "veri": { "kod": "DOLAR", "ad": "Dolar", "deger": 48.49, "degisim": 0.12, "yon": "yukari" }
}

Canlı durum

Küme	Durum	Güncelleme	Plan
Namaz vakitleri	güncel	4.9 sa önce	günde 1 (00:20 sonrası)
Finans	güncel	52 dk önce	her 60 dk
Hava durumu	güncel	32 dk önce	her 60 dk
Puan durumu	güncel	7.2 sa önce	saat 10, 13, 16, 19, 22
Fikstür	güncel	7.2 sa önce	saat 10, 13, 16, 19, 22

Yerleşim verisi (/v1/yerler) statik olduğu için bu tabloda yer almaz.
Kaynaklar: haber7 (namaz, finans, futbol), Open-Meteo (hava), GeoNames — CC BY 4.0 (yerler). Takım logoları bu sunucuya aynalanır (/resim/futbol/…). Veriler bilgilendirme amaçlıdır.