Okuyucular, araştırmacılar ve geliştiriciler için

İçeriğe erişim ve kaynak gösterme

Herkese açık makaleler, açık referanslar ve asıl içeriğe uzanan kalıcı bir bağlantı.

Okuyun ve keşfedin

Makale sayfaları, herkese açık yazılar için JavaScript veya hesap gerektirmeden okunabilir metin ve referanslar içerir. Koleksiyonun tamamını makale arşivinde, kanonik URL’leri site haritasında, en son 50 yazıyı RSS akışında ve bir metin dizinini llms.txt içinde bulabilirsiniz.

Salt okunur makale API’si

Herkese açık makalelerin dışa aktarımları API anahtarı gerektirmez. JSON için /api/public/articles/ARTICLE-SLUG adresine bir GET isteği gönderin veya Markdown için ?format=markdown ekleyin. Bu biçimler, okuma sayfasıyla aynı kayıtlı makaleden üretilir; başlıkları, listeleri, bağlantıları, görsel künyelerini ve editoryal açıklamaları korur.

JSON örneğini, onun Markdown sürümünü ve asıl makaleyi deneyin.

JSON; url (kanonik okuma sayfası), başlık, açıklama, yazar, yayıncı, dil, konu, publishedAt, modifiedAt, body.format, body.text ve makale links alanlarını içerir. Bağlantılar, metinde bulunan referanslardır; bunların bulunması, bağlantı verilen her sayfanın her ifadeyi desteklediği anlamına gelmez. Tüm tarihler ISO 8601 biçimindedir.

Makaleleri listeleyin ve güncellemeleri takip edin

Yalnızca meta veri için /api/public/articles?limit=24 adresini isteyin. Varsayılan sınır 6, üst sınır ise 24’tür. Sonraki sayfa için page=2 kullanın. İsteğe bağlı topic bir konu kısa adını, author ise pozitif bir yazar kimlik numarasını kabul eder. Yanıt; docs, hasNextPage, totalPages ve nextAfter alanlarını içerir.

Devam sayfalaması için döndürülen nextAfter.at değerini afterAt, nextAfter.id değerini ise afterId olarak gönderin; her ikisini de URL kodlamasıyla kodlayın. Aynı filtreleri ve sınırı koruyun. hasNextPage true olduğu sürece devam edin. Meta verileri listelemek, erişimi kısıtlı makale gövdelerinin kilidini açmaz.

Erişim sınırları ve güncellik

Tam metin uç noktası, yalnızca yayın zamanı gelmiş ve yayımlanmış herkese açık makaleler için kullanılabilir. Bilinmeyen makaleler, taslaklar, zamanlanmış yazılar ve hesap ya da üye erişimi gerektiren gövdeler 404 döndürür. Geçersiz biçimler veya liste parametreleri 400 döndürür. Uç nokta GET ve HEAD kabul eder; yazma yöntemleri desteklenmez. Giriş yapmak, dışa aktarım erişimini açmaz.

Dışa aktarımlar istek üzerine oluşturulur ve düzeltilmiş metin ile erişim değişikliklerinin yeniden kontrol edilmesi için Cache-Control: no-store kullanır. HTTP Link üst bilgisi, kanonik HTML sayfasını belirtir. Lütfen verileri sırayla alın, tekrarlanan toplu indirmelerden kaçının ve geçici sunucu hatalarında biraz bekledikten sonra yeniden deneyin.

Kaynak gösterme, dayanaklar ve yeniden kullanım

Bir makaleye atıfta bulunurken kanonik URL’sini, başlığını, belirtilen yazarını ve yayın tarihini kullanın; referansınız için önemliyse değiştirilme tarihini de kaydedin. Kur’an pasajı, çeviri, bağlantı verilen kaynak ve yayının kendi açıklaması arasındaki ayrımı koruyun. Editoryal ekip imzaları ekipleri belirtir ve bireysel ilmî yeterlilik anlamına gelmez.

Kişisel düşünceler ve uygulamalı rehberler, yetkin kişilerden alınan dinî eğitimin yerini tutmaz. Yoruma ve inanç esaslarına ilişkin yazılar, editoryal ilkelerimizdeki inceleme gerekliliklerine tabidir. Düzeltmeler ve önemli ilişkiler, alıntılarda da olmak üzere makaleyle birlikte yer almalıdır.

Herkese açık erişim, telif hakkını değiştirmez veya makalelerin tamamını yeniden yayımlama ya da künyeleri kaldırma lisansı vermez. Koşullarımız kapsamında bağlantıları paylaşın ve kaynak göstererek hukuka uygun alıntılar yapın. Düzeltme veya izin talepleri Yardım üzerinden iletilebilir.