مواد تک رسائی اور انتساب

سب کے لیے دستیاب مضامین، واضح حوالے اور اصل تحریر تک واپس لے جانے والا مستقل لنک۔

پڑھیں اور دریافت کریں

عوامی تحریروں کے صفحات پر JavaScript یا اکاؤنٹ کے بغیر قابلِ مطالعہ متن اور حوالے دستیاب ہوتے ہیں۔ مکمل مجموعہ مضامین کے آرکائیو میں، کینونیکل URLs سائٹ میپ میں، تازہ ترین 50 تحریریں RSS فیڈ میں، اور متنی اشاریہ llms.txt میں دیکھیں۔

مضامین کی صرف پڑھنے کی رسائی دینے والی API

عوامی مضامین ایکسپورٹ کرنے کے لیے API کلید درکار نہیں۔ JSON کے لیے /api/public/articles/ARTICLE-SLUG پر GET درخواست بھیجیں، یا Markdown کے لیے آخر میں ?format=markdown شامل کریں۔ یہ فارمیٹس اسی محفوظ کردہ مضمون سے بنتے ہیں جس سے مطالعے کا صفحہ بنتا ہے، اور ان میں سرخیاں، فہرستیں، لنکس، تصاویر کے کریڈٹ اور ادارتی انکشافات برقرار رہتے ہیں۔

JSON کی مثال، اس کا Markdown نسخہ، اور اصل مضمون دیکھیں۔

JSON میں url (مطالعے کا کینونیکل صفحہ)، عنوان، وضاحت، مصنف، ناشر، زبان، موضوع، publishedAt، modifiedAt، body.format، body.text، اور مضمون کے links شامل ہوتے ہیں۔ لنکس متن میں موجود حوالے ہیں؛ ان کی موجودگی کا مطلب یہ دعویٰ نہیں کہ ہر منسلک صفحہ ہر بیان کی تائید کرتا ہے۔ تمام تاریخیں ISO 8601 استعمال کرتی ہیں۔

مضامین کی فہرست حاصل کریں اور تازہ کاریوں سے باخبر رہیں

صرف میٹاڈیٹا کے لیے /api/public/articles?limit=24 کی درخواست کریں۔ طے شدہ حد 6 ہے؛ زیادہ سے زیادہ حد 24 ہے۔ اگلے صفحے کے لیے page=2 استعمال کریں۔ اختیاری topic کسی موضوع کا سلگ قبول کرتا ہے اور author مصنف کی مثبت عددی ID قبول کرتا ہے۔ جواب میں docs، hasNextPage، totalPages، اور nextAfter شامل ہوتے ہیں۔

صفحہ بندی جاری رکھنے کے لیے جواب میں ملنے والے nextAfter.at کو afterAt اور nextAfter.id کو afterId کے طور پر بھیجیں، اور دونوں کو URL-encode کریں۔ فلٹرز اور حد وہی رکھیں۔ جب تک hasNextPage کی قدر true ہو، جاری رکھیں۔ فہرست کا میٹاڈیٹا حاصل کرنے سے محدود رسائی والے مضامین کا متن دستیاب نہیں ہوتا۔

رسائی کی حدود اور مواد کی تازگی

مکمل متن کا اینڈپوائنٹ صرف ان شائع شدہ عوامی مضامین کے لیے دستیاب ہے جن کی اشاعت کا مقررہ وقت آ چکا ہو۔ نامعلوم مضامین، مسودے، آئندہ اشاعت کے لیے طے شدہ تحریریں، اور اکاؤنٹ یا رکنیت سے مشروط مضامین کے متن کے لیے 404 ملتا ہے۔ غلط فارمیٹس یا فہرست کے غلط پیرامیٹرز کے لیے 400 ملتا ہے۔ یہ اینڈپوائنٹ GET اور HEAD قبول کرتا ہے؛ ڈیٹا لکھنے والے میتھڈز کی سہولت موجود نہیں ہے۔ سائن اِن کرنے سے ایکسپورٹ کی رسائی نہیں کھلتی۔

ایکسپورٹس درخواست پر تیار کیے جاتے ہیں اور Cache-Control: no-store استعمال کرتے ہیں تاکہ تصحیح شدہ متن اور رسائی کی تبدیلیاں دوبارہ جانچی جائیں۔ ان کا HTTP Link ہیڈر کینونیکل HTML صفحے کی نشاندہی کرتا ہے۔ براہِ کرم درخواستیں یکے بعد دیگرے بھیجیں، بار بار بڑے پیمانے پر ڈاؤن لوڈ کرنے سے گریز کریں، اور سرور کی عارضی خرابیوں کے بعد کچھ وقفے سے دوبارہ کوشش کریں۔

انتساب، ماخذ اور دوبارہ استعمال

کسی مضمون کا حوالہ دیتے وقت اس کا کینونیکل URL، سرخی، درج شدہ مصنف اور تاریخِ اشاعت استعمال کریں؛ جب ترمیم کی تاریخ آپ کے حوالے کے لیے اہم ہو تو اسے بھی درج کریں۔ قرآن کی عبارت، ترجمے، لنک کیے گئے ماخذ اور اشاعت کی اپنی توضیح کے درمیان فرق برقرار رکھیں۔ ادارتی شعبے کے نام سے دی گئی تصنیفی نسبت ٹیموں کی شناخت کرتی ہے اور کسی فرد کی علمی اہلیت کا دعویٰ نہیں کرتی۔

ذاتی تاثرات اور عملی رہنما مضامین اہل فرد کی دینی تعلیم کا متبادل نہیں ہیں۔ تفسیری اور عقائد سے متعلق تحریروں پر ہمارے ادارتی اصولوں میں درج جائزے کے تقاضے لاگو ہوتے ہیں۔ تصحیحات اور اہم تعلقات کی وضاحت مضمون کے ساتھ رہنی چاہیے، اس کے اقتباسات میں بھی۔

عوامی رسائی سے حقِ تصنیف نہیں بدلتا، نہ ہی مکمل مضامین دوبارہ شائع کرنے یا کریڈٹ ہٹانے کا اجازت نامہ ملتا ہے۔ ہماری شرائط کے تحت لنکس شیئر کریں اور انتساب کے ساتھ قانوناً جائز اقتباسات استعمال کریں۔ تصحیح یا اجازت کی درخواستیں مدد کے ذریعے کی جا سکتی ہیں۔