# Sünnetimiz.com — Hadis API > Türkçe hadis kütüphanesi (Kütüb-i Sitte ve daha fazlası): Arapça metin, Türkçe meal, dereceler, kitâb/bâb yapısı. Ücretsiz JSON API, anahtar gerekmez, CORS açık, yalnızca GET. - Base URL: https://sunnetimiz.com/api/v1 - Belgeler (insan): https://sunnetimiz.com/api-bilgi - OpenAPI 3.1: https://sunnetimiz.com/api/v1/openapi.json - İletişim / toplu veri: info@hollandstechniek.nl ## Uç noktalar - GET https://sunnetimiz.com/api/v1/books Tüm kitaplar: hadis sayısı, kitâb sayısı ve durum (full = Türkçe meal + Arapça, arabic_only = yalnızca Arapça). params: yok example: https://sunnetimiz.com/api/v1/books - GET https://sunnetimiz.com/api/v1/books/{slug} Tek bir kitap ve içindeki kitâb (bölüm) listesi. params: slug* (path) — Kitap kısa adı (bkz. /books) example: https://sunnetimiz.com/api/v1/books/buhari - GET https://sunnetimiz.com/api/v1/books/{slug}/kitabs/{n} Bir kitâbın hadisleri, sayfalandırılmış (Türkçe, Arapça, derece, bâb). params: slug* (path) — Kitap kısa adı; n* (path) — Kitâb numarası; page (query) — Sayfa numarası; limit (query) — Sayfa başına hadis (1–100) example: https://sunnetimiz.com/api/v1/books/buhari/kitabs/2?limit=5 - GET https://sunnetimiz.com/api/v1/hadith/{slug}:{number} Bir hadisin Türkçe meali, Arapça metni, derecesi, kitâb ve bâb bilgisi; önceki/sonraki bağlantıları. params: ref* (path) — kitap:numara biçiminde; isnad (query) — 1 verilirse râvî zincirinin adları (Türkçe okunuşu + Arapça) eklenir. Otomatik çıkarılmıştır, doğrulanmamıştır. example: https://sunnetimiz.com/api/v1/hadith/buhari:1?isnad=1 - GET https://sunnetimiz.com/api/v1/search Türkçe veya Arapça metinde arama (hızlı tam metin araması). Sonuçlar önem sırasına göre gelir. params: q* (query) — Aranan kelime(ler), 2–100 karakter; lang (query) — tr veya ar (Arapça harf varsa otomatik ar); book (query) — Virgülle ayrılmış kitap kısa adları; match (query) — all = tüm kelimeler, any = herhangi biri; limit (query) — Sayfa başına sonuç (1–50); page (query) — Sayfa (1–20) example: https://sunnetimiz.com/api/v1/search?q=niyet&book=buhari&limit=3 - GET https://sunnetimiz.com/api/v1/random Türkçe mealli rastgele bir hadis — “günün hadisi” bileşenleri için. params: book (query) — İsteğe bağlı kitap kısa adı example: https://sunnetimiz.com/api/v1/random ## Kitap kısa adları (slug) - buhari: Sahih-i Buhari (صحيح البخاري) - muslim: Sahih-i Müslim (صحيح مسلم) - nesai: Sünen-i Nesâî (سنن النسائي) - ebudavud: Sünen-i Ebû Dâvûd (سنن أبي داود) - tirmizi: Sünen-i Tirmizî (جامع الترمذي) - ibnmace: Sünen-i İbn Mâce (سنن ابن ماجه) - malik: Muvatta' (موطأ مالك) - ahmed: Müsned-i Ahmed (مسند أحمد) - darimi: Sünen-i Dârimî (سنن الدارمي) - hakim: el-Müstedrek (المستدرك على الصحيحين) - ibnhibban: Sahîh İbn Hibbân (صحيح ابن حبان) - ibnhuzeyme: Sahîh İbn Huzeyme (صحيح ابن خزيمة) - beyhaki: es-Sünenü'l-Kübrâ (السنن الكبرى للبيهقي) - darekutni: Sünen-i Dârekutnî (سنن الدارقطني) - ibnebisyebe: Musannef İbn Ebî Şeybe (مصنف ابن أبي شيبة) - abdurrezzak: Musannef Abdürrezzâk (مصنف عبد الرزاق) - taberani: el-Mu'cemü'l-Kebîr (المعجم الكبير) - edebmufred: el-Edebü'l-Müfred (الأدب المفرد) - riyazussalihin: Riyâzü's-Sâlihîn (رياض الصالحين) - kirkhadis: Kırk Hadis (Nevevî) (الأربعون النووية) - bulugulmeram: Bulûğu'l-Merâm (بلوغ المرام) - miskat: Mişkâtü'l-Mesâbîh (مشكاة المصابيح) - semail: Şemâil-i Muhammediyye (الشمائل المحمدية) - umdetulahkam: Umdetü'l-Ahkâm (عمدة الأحكام) ## Yanıt biçimi Her hadis: ref ("buhari:1"), url, book{slug,name,name_ar}, kitab{number,title,title_ar}, bab{number,title_ar}|null, number, turkish (Türkçe meal; yalnızca-Arapça kitaplarda null), arabic, grade{label,by,tone}|null. Her yanıtta meta.attribution = "Kaynak: Sünnetimiz.com". Liste yanıtları pagination{page,limit,total,pages,next,prev} veya has_more/next içerir. Hata: { "error": { "code": "...", "message": "..." } } — 400/404/429/500. ## Limitler (IP başına) - Dakika başına: 60 istek (IP başına) - Gün başına: 3.000 istek (IP başına) - Arama: dakikada 20 istek - Sayfa boyutu: en fazla 100 hadis (arama: 50) - Arama sayfası: en fazla 20 sayfa 429 durumunda Retry-After (saniye) başlığını bekleyin. Yanıtlar önbelleğe alınabilir (Cache-Control); lütfen istemci tarafında da önbellekleyin. ## Kurallar - Her hadisin yanında "Kaynak: Sünnetimiz.com" (https://sunnetimiz.com bağlantısıyla) gösterin; metni değiştirmeyin. - Isnad/râvî bilgisi (?isnad=1) otomatik çıkarılmıştır ve doğrulanmamıştır; kullanıcıya bunu belirtin. - Tüm veriyi toplu çekmeyin; toplu veri için info@hollandstechniek.nl adresine e-posta gönderin (JSON/SQLite olarak elle göndeririz). - Hadis metinlerinin hakları ilgili çevirmen/yayıncı ve kaynaklara aittir; ticari kullanım için önce yazın. ## Türkçe çevirmenler - Sahih-i Buhari: Mehmed Sofuoğlu — Ötüken Neşriyat - Sahih-i Müslim: Ahmed Davudoğlu — Sönmez Neşriyat - Sünen-i Ebû Dâvûd: Necati Yeniel – Hüseyin Kayapınar — Şamil Yayınevi (İstanbul) - Sünen-i Tirmizî: Abdullah Parlıyan — Konya Kitapçılık (2004) - Sünen-i Nesâî: Abdullah Parlıyan — Konya Kitapçılık - Sünen-i İbn Mâce: Haydar Hatîpoğlu — Kahraman Yayınları - Muvatta (İmam Mâlik): Ahmet Büyükpınar — Beyan Yayınları - Riyâzü’s-Sâlihîn: Abdullah Parlıyan — Konya Kitapçılık ## Veri kaynakları - Türkçe hadis mealleri: Sahih-i Buhari, Sahih-i Müslim, Sünen-i Ebû Dâvûd, Tirmizî, Nesâî, İbn Mâce ve Muvatta: fawazahmed0/hadith-api projesindeki Türkçe sürümler (tur-bukhari, tur-muslim, …). Projenin kendisi Unlicense ile yayımlanmıştır, ancak sürümlerde çevirmen adı yazmaz. Metinler, Darul Kitap / İslami Okul (darulkitap.com, islamiokul.com) üzerindeki yayımlanmış Türkçe çevirilerle örtüşür; çevirmen ve yayınevi künyeleri aşağıdaki tabloda ve ilgili kitap yanıtlarında (translation alanı) verilmiştir. Meallerin hakları çevirmenlere ve yayınevlerine aittir; yeniden yayın izni bizim tarafımızdan ayrıca doğrulanmamıştır. https://github.com/fawazahmed0/hadith-api - Arapça metinler: Kütüb-i Sitte ve Muvatta: hadith-api (fawazahmed0). Boşluklar Shamela dayanaklı “kutub-sittah-jsonl” ve hadithunlocked.com Arapça verisiyle tamamlandı. https://github.com/hassanmsthf11/kutub-sittah-jsonl - Bâb (alt bölüm) başlıkları: Arapça bâb başlıkları Shamela dayanaklı açık “kutub-sittah-jsonl” verisinden alındı ve hadislerle metin hizalamasıyla eşleştirildi (%98–100). https://github.com/hassanmsthf11/kutub-sittah-jsonl - Yalnızca Arapça kitaplar: Müsned-i Ahmed, Müstedrek, İbn Hibbân, İbn Huzeyme, Beyhakî, Dârekutnî, İbn Ebî Şeybe, Abdürrezzâk, Taberânî (Kebîr): hadithunlocked.com (Arapça, dereceleriyle). Riyâzü’s-Sâlihîn, Bulûğu’l-Merâm, Mişkât, Dârimî, Edebü’l-Müfred, Şemâil, Kırk Hadis: hadith-json (AhmedBaset). Umdetü’l-Ahkâm: okabe-r/Umdat-al-Ahkam. https://hadithunlocked.com - Hadis dereceleri: Kaynak veri setlerindeki dereceler (ör. el-Elbânî, Şuayb el-Arnaût, ez-Zehebî, Alî Zâî). Buhârî ve Müslim’in Sahîh’lerindeki hadisler kitabın şartı gereği sahih gösterilir. https://hadithunlocked.com - Râvî (senet) bilgileri: Isnad zinciri hadis metninden otomatik çıkarılır; râvî profilleri Itqan açık veri setinden (AR-Sanad, OpenITI vb. kaynaklardan derlenmiş) otomatik eşleştirilir. Doğrulanmamıştır; hatalar olabilir. API yalnızca râvî adlarını verir. https://github.com/R3GENESI5/Itqan - Düzeltmeler: Sünnetimiz çevirmen ve editörleri, Selef-i Sâlihîn anlayışına (Kur’ân ve Sünnet) göre meallerde düzeltme yapabilir; API en güncel yayımlanmış metni döndürür.