Akses kandungan dan atribusi
Artikel awam, rujukan yang jelas dan pautan yang stabil ke artikel asal.
Baca dan terokai
Halaman artikel mengandungi teks dan rujukan yang boleh dibaca tanpa memerlukan JavaScript atau akaun bagi artikel awam. Temui koleksi lengkap dalam arkib artikel, URL kanonik dalam peta laman, 50 artikel terkini dalam suapan RSS, dan indeks teks dalam llms.txt.
API artikel baca sahaja
Eksport artikel awam tidak memerlukan kunci API. Hantar permintaan GET ke /api/public/articles/ARTICLE-SLUG untuk JSON, atau tambahkan ?format=markdown untuk Markdown. Format ini berasal daripada artikel tersimpan yang sama dengan halaman bacaan, dengan mengekalkan tajuk bahagian, senarai, pautan, kredit imej dan pendedahan editorial.
Cuba contoh JSON, versi Markdown dan artikel asal.
JSON merangkumi url (halaman bacaan kanonik), tajuk, perihalan, pengarang, penerbit, bahasa, topik, publishedAt, modifiedAt, body.format, body.text dan links artikel. Pautan ialah rujukan yang terdapat dalam teks; kewujudannya bukan dakwaan bahawa setiap halaman yang dipautkan menyokong setiap kenyataan. Semua tarikh menggunakan ISO 8601.
Senaraikan artikel dan ikuti kemas kini
Minta /api/public/articles?limit=24 untuk metadata sahaja. Had lalai ialah 6; had maksimum ialah 24. Gunakan page=2 untuk halaman seterusnya. Parameter pilihan topic menerima slug topik dan author menerima ID pengarang bernilai positif. Respons merangkumi docs, hasNextPage, totalPages dan nextAfter.
Untuk meneruskan ke halaman seterusnya, hantarkan nilai nextAfter.at yang dipulangkan sebagai afterAt dan nextAfter.id sebagai afterId, dengan mengekodkan kedua-duanya untuk URL. Kekalkan penapis dan had yang sama. Teruskan selagi hasNextPage bernilai benar. Penyenaraian metadata tidak membuka akses kepada kandungan artikel yang dihadkan.
Had akses dan kemutakhiran
Titik akhir teks penuh hanya tersedia untuk artikel awam yang telah diterbitkan dan masa penerbitannya telah tiba. Artikel yang tidak dikenali, draf, artikel berjadual serta kandungan artikel yang memerlukan akaun atau keahlian memulangkan 404. Format atau parameter senarai yang tidak sah memulangkan 400. Titik akhir ini menerima GET dan HEAD; kaedah untuk menulis data tidak disokong. Log masuk tidak membuka akses kepada eksport.
Eksport dijana apabila diminta dan menggunakan Cache-Control: no-store supaya teks yang telah dibetulkan dan perubahan akses disemak semula. Pengepala HTTP Link mengenal pasti halaman HTML kanonik. Sila ambil artikel satu demi satu, elakkan muat turun pukal berulang dan cuba semula selepas jeda jika berlaku kegagalan pelayan sementara.
Atribusi, sumber dan penggunaan semula
Apabila merujuk artikel, gunakan URL kanonik, tajuk, pengarang yang dinyatakan dan tarikh penerbitannya; catat tarikh pengubahsuaian apabila penting untuk rujukan anda. Kekalkan perbezaan antara petikan al-Quran, terjemahan, sumber yang dipautkan dan penjelasan penerbitan itu sendiri. Nama unit editorial pada baris pengarang merujuk kepada pasukan dan tidak membayangkan kelayakan ilmiah individu.
Renungan peribadi dan panduan praktikal tidak menggantikan bimbingan agama daripada pihak berkelayakan. Penulisan berbentuk tafsiran dan doktrin agama mengikut keperluan semakan dalam prinsip editorial kami. Pembetulan dan hubungan yang penting perlu disertakan bersama artikel, termasuk dalam petikan.
Akses awam tidak mengubah hak cipta atau memberikan lesen untuk menerbitkan semula artikel penuh atau membuang kredit. Kongsi pautan dan gunakan petikan yang dibenarkan undang-undang dengan atribusi menurut terma kami. Permintaan pembetulan atau kebenaran boleh dibuat melalui Bantuan.