Takvim API

Türkiye resmî tatilleri, dinî günler, kandiller, ay evreleri ve mevsim başlangıçları için ücretsiz JSON API. Kayıt yok, anahtar yok, kota yok. Uygulamanızda, sitenizde veya betiğinizde doğrudan kullanabilirsiniz.

Ücretsizanahtar gerektirmez
CORS açıktarayıcıdan çağrılabilir
2016–2036veri kapsamı
JSON+ JSONP desteği

Hızlı başlangıç

Bir isteğe ne döndüğünü görmek en kolayı:

curl https://onlinetakvi.com/api/v1/tatiller/2027

Yanıt:

{ "yil": 2027, "ulke": "TR", "toplam": 16, "tam_gun_sayisi": 13, "tatiller": [ { "tarih": "2027-01-01", "ad": "Yılbaşı", "tur": "resmi", "tam_gun": true, "gun": "Cuma", "tahmini": false }, ... ] }

Canlı yanıtı gör →

Uç noktalar

GET/api/v1/tatiller/{yil}

Resmî tatiller — Yılın tüm resmî tatilleri: millî bayramlar, dinî bayramlar ve yarım günler. Her kayıtta tarih, ad, tür ve haftanın günü bulunur.

Dene: /api/v1/tatiller/2027 →
GET/api/v1/dini-gunler/{yil}

Dinî günler ve kandiller — Regaib, Miraç, Berat, Kadir ve Mevlid kandilleri, Ramazan başlangıcı, hicrî yılbaşı ve Aşure. Hicrî karşılıklarıyla birlikte.

Dene: /api/v1/dini-gunler/2027 →
GET/api/v1/onemli-gunler/{yil}

Önemli günler ve haftalar — Belirli gün ve haftalar. Tarihi her yıl değişenler (Anneler Günü gibi) o yıl için hesaplanmış olarak döner.

Dene: /api/v1/onemli-gunler/2027 →
GET/api/v1/ay-evreleri/{yil}

Ay evreleri — Yeni ay, ilk dördün, dolunay ve son dördün tarihleri; Türkiye saatiyle dakika hassasiyetinde.

Dene: /api/v1/ay-evreleri/2027 →
GET/api/v1/mevsimler/{yil}

Mevsim başlangıçları — Ekinoks ve gündönümlerinin tarih ve saatleri.

Dene: /api/v1/mevsimler/2027 →
GET/api/v1/gun/{YYYY-AA-GG}

Tek günün künyesi — Bir tarihe ait her şey: haftanın günü, hafta numarası, yılın kaçıncı günü, hicrî karşılığı, burç, tatil durumu, dinî ve önemli günler, ay evresi.

Dene: /api/v1/gun/2027-04-23 →
GET/api/v1/bugun

Bugün — Yukarıdakinin bugüne uygulanmış hâli. Sunucu saati Europe/Istanbul.

Dene: /api/v1/bugun →
GET/api/v1/hicri/{YYYY-AA-GG}

Hicrî çevirici — Miladi tarihin hicrî karşılığı, ayın başlangıcı ve uzunluğuyla birlikte.

Dene: /api/v1/hicri/2027-04-23 →
GET/api/v1/tatil-mi/{YYYY-AA-GG}

Tatil kontrolü — Tek soruya tek cevap: bu gün çalışma günü mü? İş günü hesabı yapan uygulamalar için.

Dene: /api/v1/tatil-mi/2027-04-23 →

Kullanım örnekleri

JavaScript

const y = await fetch('https://onlinetakvi.com/api/v1/tatiller/2027') .then(r => r.json()); y.tatiller .filter(t => t.tam_gun) .forEach(t => console.log(t.tarih, t.ad));

PHP

$v = json_decode(file_get_contents( 'https://onlinetakvi.com/api/v1/tatil-mi/2027-04-23' ), true); if ($v['calisma_gunu']) { // iş günü hesabına dahil et }

Python

import requests v = requests.get( 'https://onlinetakvi.com/api/v1/gun/2027-04-23' ).json() print(v['hicri']['metin']) # hicrî karşılığı print(v['tatil']['ad']) # tatil adı

JSONP (eski tarayıcılar)

<script src="https://onlinetakvi.com/api/v1/bugun?geri_cagirma=yaz"></script> <script>function yaz(v) { console.log(v.haftanin_gunu); }</script>

Hatalar

Hatalı istekler uygun HTTP durum koduyla ve aynı biçimde döner:

{ "hata": true, "mesaj": "Yıl 2050 desteklenmiyor. Geçerli aralık: 2016–2036", "kod": 404, "gecerli_aralik": { "baslangic": 2016, "bitis": 2036 } }
KodAnlamı
200Başarılı
400Tarih biçimi hatalı (beklenen: YYYY-AA-GG)
404Bilinmeyen uç nokta ya da kapsam dışı yıl

Önemli notlar

Tahminî tarihler. Dinî günler hicrî takvime bağlıdır. Diyanet İşleri Başkanlığı takvimi henüz yayımlanmamış yıllarda tarihler hesaplanarak tahmin edilir ve yanıtta "tahmini": true olarak işaretlenir. Bu alanı kontrol edin — ileri yıl tarihleri Diyanet takvimi açıklandığında bir gün kayabilir. Nasıl hesapladığımızı metodoloji sayfasında anlattık.

Önbellek. Yanıtlar 6 saat önbelleklenir (Cache-Control: max-age=21600). Veriler günlük değişmediği için siz de kendi tarafınızda önbelleklerseniz herkes için daha hızlı olur.

Adil kullanım. Kota koymuyoruz. Buna karşılık, aynı yılın verisini saniyede defalarca istemek yerine bir kez alıp saklamanızı rica ediyoruz.

Kararlılık. /api/v1/ altındaki alan adları geriye dönük uyumlu tutulur; yeni alanlar eklenebilir, mevcut alanlar kaldırılmaz. Kırıcı bir değişiklik olursa /api/v2/ olarak yayımlanır.

Lisans

Veriyi kişisel ve ticari projelerinizde ücretsiz kullanabilirsiniz. Zorunlu değil ama kaynak olarak onlinetakvi.com'a bağlantı vermeniz bizim için değerli — bu API'yi ücretsiz tutmamızı sağlayan tek şey o.

Bir hata fark ederseniz ya da yeni bir uç nokta ihtiyacınız varsa bize yazın; veriyi düzeltmek ve genişletmek istiyoruz.

İlgili

.ics takvim aboneliği Gömülebilir widget Metodoloji Resmî tatiller