Başlangıç ve kimlik doğrulama

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

Anahtar alma, istek gönderme, ortak yanıt zarfı, hata kodları ve önbellek kuralları.

Erişimherkese açıkküme dışı

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

Kaynak—

Tazeleme—

Servis salt okunur bir JSON API'sidir: yalnız GET (ve HEAD) kabul eder, yanıtlar UTF-8 JSON'dur ve CORS her kökene açıktır. Tarayıcıdan doğrudan çağırabilirsiniz; bu durumda anahtarınız sayfa kaynağında görüneceği için yalnız herkese açık uçlarda ya da kendi sunucunuz üzerinden kullanın.

Uç noktalar

GET/hesap/kayit

Ücretsiz hesap açar; ilk anahtar anında üretilir ve bir kez gösterilir.

GET/hesap

Anahtarlarınız, günlük kullanım, son istekler, parola değişikliği.

GET/v1/durum

Sağlık ucu. Anahtar istemez; kümelerden biri bayatsa 503 döner.

Parametreler

Parametre	Yer	Açıklama
`X-Api-Key`	başlık	Önerilen yol. `X-Api-Key: ss_…` biçiminde gönderilir.
`anahtar`	sorgu	Başlık gönderemeyen istemciler için: `?anahtar=ss_…`. İstek günlüğünde gizlenir.

Alanlar

Her yanıtta bulunan alanlar

Alan	Tip	Açıklama
`ok`	bool	İstek başarılıysa `true`. Hata yanıtlarında `false`.
`kume`	string	Verinin ait olduğu küme: `namaz`, `finans`, `hava`, `puan`, `fikstur`. Yerleşim ve şehir uçlarında bulunmaz.
`kaynak`	string	Verinin alındığı dış kaynak.
`guncelleme`	string	Verinin çekildiği an; ISO 8601, Türkiye saati (ör. `2026-09-30T17:10:02+03:00`).
`yas_sn`	int	Verinin kaç saniye önce çekildiği.
`bayat`	bool	Veri o küme için tanımlı tazelik eşiğini aştıysa `true`. Yanıt yine de son geçerli veriyle döner.

Hata yanıtı

Alan	Tip	Açıklama
`ok`	bool	Her zaman `false`.
`hata`	string	İnsan okuru için Türkçe açıklama.
`kod`	int	HTTP durum kodunun gövdedeki kopyası.

Örnek yanıt

Hata · anahtarsız istek (HTTP 401)

{
  "ok": false,
  "hata": "API anahtarı gerekli: X-Api-Key başlığı ya da ?anahtar= parametresi.",
  "kod": 401,
  "kayit": "https://api.sanater.com/hesap/kayit"
}

Kullanım

curl

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

PHP

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

if (!($veri['ok'] ?? false)) {
    throw new RuntimeException($veri['hata'] ?? 'bilinmeyen hata');
}

JavaScript

const r = await fetch('https://api.sanater.com/v1/finans', {
  headers: { 'X-Api-Key': 'ss_…' },
});
const veri = await r.json();
if (!veri.ok) throw new Error(veri.hata);
console.log(veri.kalemler);

Bilinmesi gerekenler

Hata kodları: 400 eksik/geçersiz parametre · 401 anahtar yok ya da tanınmıyor · 403 anahtar iptal edilmiş, hesap askıda ya da anahtar o kümeye yetkili değil · 404 il/lig/ülke bulunamadı · 405 GET dışında bir yöntem · 429 günlük limit aşıldı · 503 bir küme bayat (yalnız /v1/durum).
Limit: Her yanıtta X-RateLimit-Limit ve X-RateLimit-Remaining başlıkları döner. Sayaç her gece 00:00'da (Türkiye) sıfırlanır. Limit anahtar başınadır; hesabınızda en çok beş anahtar tutabilirsiniz.
Küme kısıtı: Anahtar oluştururken kümeleri seçebilirsiniz. Kısıtlı bir anahtarla başka kümeye istek 403 döner — üretimde her site için ayrı ve dar yetkili anahtar kullanın.
Önbellek: Yanıtlar ETag taşır; If-None-Match gönderirseniz veri değişmediğinde 304 alırsınız ve bu istek de limitten düşer. Anahtar gerektiren yanıtlar private işaretlidir, paylaşımlı önbelleklere girmez.
İstek günlüğü: Gönderdiğiniz her istek (yol, küme, yanıt kodu, süre) hesabınızda listelenir; /hesap/istekler sayfasından görebilirsiniz.

← Tüm belgeler