İçeriğe geç
TarihSaat

Geliştirici

TarihSaat Zaman Dilimi API Dokümantasyonu

TarihSaat’in herkese açık uç noktaları: sunucu saati (JSON), günün özeti, gömülebilir canlı saat ve geri sayım widget’ları ile blog RSS akışı. Anahtar gerekmez.

Herkese Açık Uç Noktalar

Aşağıdaki uç noktalar anahtar gerektirmez ve şu an çalışır durumdadır. Otomatik ve sık sorgularda yanıtları kendi tarafınızda önbelleğe alın.

GET/api/bugunBugünün tarih bilgisi (JSON)
Örnek
curl https://tarihsaat.com/api/bugun

// Tarayıcıdan (CORS açık)
fetch('https://tarihsaat.com/api/bugun').then((r) => r.json()).then(console.log);
Örnek yanıt (JSON, 6 Ekim 2026)
{
  "tarih": "2026-10-06",
  "tarihMetni": "6 Ekim 2026 Salı",
  "gunAdi": "Salı",
  "yilinGunu": 279,
  "isoHafta": 41,
  "isoHaftaYili": 2026,
  "hicri": "25 Rebiülahir 1448",
  "saatDilimi": { "iana": "Europe/Istanbul", "utcFarki": "+03:00" },
  "sonrakiTatil": {
    "ad": "Cumhuriyet Bayramı",
    "tarih": "2026-10-29",
    "sonGun": "2026-10-29",
    "kalanGun": 23,
    "geriSayimHedefi": "2026-10-28T21:00:00.000Z",
    "tamGunSayisi": 1,
    "devamEdiyor": false,
    "arife": {
      "tarih": "2026-10-28",
      "baslangicSaati": "13:00",
      "baslangic": "2026-10-28T10:00:00.000Z",
      "kalanGun": 22
    },
    "url": "https://tarihsaat.com/kac-gun-kaldi/29-ekim"
  },
  "gunes": { "konum": "İstanbul", "dogus": "07:06", "batis": "18:40", "gunUzunluguDk": 694 },
  "olusturulma": "2026-10-06T07:00:00.000Z"
}

Değerler Türkiye saatine (Europe/Istanbul) göredir; güneş saatleri İstanbul içindir. sonrakiTatil.tarih ve kalanGun ilk TAM tatil gününü verir (sitede ve /kac-gun-kaldi sayfalarında gösterilen "X gün kaldı" ile aynı sayı); sonGun tatilin son günü, tamGunSayisi tam tatil günü sayısıdır. geriSayimHedefi, ilk tam günün 00:00 TSİ anının UTC karşılığıdır. Yarım günlük arife (bayram arifeleri ve 28 Ekim, 13:00’ten itibaren) yalnızca varsa isteğe bağlı arife nesnesinde yer alır; arife.baslangic 13:00 TSİ anını UTC olarak verir. Öngörülen (kesinleşmemiş) dini bayram tarihlerinde ongorulen: true eklenir; url yalnızca geri sayım sayfası olan tatillerde bulunur. Tatil başlamışsa (arifenin 13:00’ünden itibaren) devamEdiyor: true olur. Yanıt 10 dakikaya kadar önbellekte tutulabilir.

GET/api/zamanSunucu saati (milisaniye)
Örnek
curl https://tarihsaat.com/api/zaman
Örnek yanıt (JSON)
{ "unixMs": 1791270000000 }

Önbelleğe alınmaz. Cihaz saati sapmasını ölçmek için istek gidiş-dönüş süresinin yarısını (RTT/2) hesaba katın.

GET/embed/saatCanlı saat widget’ı (HTML, iframe için)
Parametreler
  • tz — IANA saat dilimi, ör. Europe/Istanbul (varsayılan), Europe/London, Asia/Tokyo
  • etiket — Başlık metni, en fazla 60 karakter (varsayılan: şehir adı)
  • stil — minimal, card (varsayılan) veya banner
Örnek
<iframe src="https://tarihsaat.com/embed/saat?tz=Europe/London&etiket=Londra&stil=card"
  title="Londra saati" width="260" height="120" style="border:0;border-radius:12px"></iframe>
Yanıt
Harici kaynak yüklemeyen tek parça HTML sayfası; saat tarayıcıda her saniye güncellenir.
GET/embed/sayacGeri sayım widget’ı (HTML, iframe için)
Parametreler
  • tarih — Hedef: YYYY-MM-DDTHH:mm veya YYYY-MM-DD (Türkiye saati, +03:00 kabul edilir)
  • etiket — Başlık metni, en fazla 60 karakter (varsayılan: “Etkinliğe”)
  • stil — minimal, card (varsayılan) veya banner
Örnek
<iframe src="https://tarihsaat.com/embed/sayac?tarih=2027-01-01T00:00&etiket=Yılbaşına&stil=banner"
  title="Yılbaşı geri sayımı" width="400" height="120" style="border:0;border-radius:12px"></iframe>
Yanıt
Gün, saat, dakika ve saniye olarak geri sayan tek parça HTML sayfası.
GET/feed.xmlBlog RSS 2.0 beslemesi
Örnek
curl https://tarihsaat.com/feed.xml
Yanıt
Son 50 blog yazısının başlık, özet ve bağlantılarını içeren RSS 2.0 (XML) beslemesi; saatlik yenilenir.

Gömme kodunu hazır almak için Widget Ekleme sayfasını kullanabilirsiniz.

TarihSaat şu an herkese açık, anahtarsız birkaç basit uç nokta sunar. Aşağıdaki adresler https://tarihsaat.com altında çalışır.

Uç Noktalar

  • GET /api/zaman — sunucu saati: {"unixMs": 1790000000000} (önbelleğe alınmaz)
  • GET /api/bugun — Türkiye saatine göre günün özeti: tarih, haftanın günü, yılın günü, ISO hafta, Hicri tarih, sıradaki resmi tatil, İstanbul gün doğumu/batımı
  • GET /embed/saat?tz=Europe/Istanbul&etiket=...&stil=minimal|card|banner — gömülebilir canlı saat (HTML)
  • GET /embed/sayac?tarih=YYYY-MM-DDTHH:mm&etiket=...&stil=minimal|card|banner — gömülebilir geri sayım (HTML)
  • GET /feed.xml — blog yazıları için RSS akışı

Kullanım Koşulları

Uç noktalar ücretsizdir ve anahtar gerektirmez. Lütfen makul sıklıkta istek gönderin; yoğun kullanım için önbellek kullanın.

TarihSaat API Dokümantasyonu ve Zaman Servisleri

API Dokümanları Neden Gerekli?

Bu sayfa, TarihSaat’in herkese açık uç noktalarını kendi sitesinde veya uygulamasında kullanmak isteyen geliştiriciler için kısa bir referanstır.

Örnek Kullanımlar

  • Cihaz saatini sunucu saatiyle karşılaştırma (/api/zaman)
  • Uygulamada günün tarih özetini gösterme (/api/bugun)
  • Siteye canlı saat veya geri sayım ekleme (/embed)

Sık Sorulan Sorular

JSON dönüyor mu?
/api/zaman ve /api/bugun JSON döndürür.

API anahtarı gerekiyor mu?
Hayır, bu uç noktalar anahtarsız ve ücretsizdir.

SSS

Sık sorulan sorular

Hangi formatlar destekleniyor?
/api/zaman ve /api/bugun JSON döndürür; /embed adresleri iframe ile gömülecek HTML sayfası, /feed.xml ise RSS (XML) döndürür.