{
  "name": "البيان — واجهة البيانات (API)",
  "about": "بيانات موسوعة البيان للقراءة: المقالات، والآيات مع تفسيرها، والأحاديث بدرجتها ورواتها، وأحوال الرواة. بلا مفتاح؛ كل عنصر فيه رابط صفحته في الموقع.",
  "links": "كل حديث وآية وراوٍ فيه link (صفحته في الموقع) وrelatedArticles: مقالات البيان وأجوبته التي تتكلم عن هذا الحديث أو الآية أو الراوي بعينه، مع روابطها.",
  "terms": "يُعرض كل نص مع مصدره «البيان» ورابطه (link) بجانبه. نصوص الكتب من مشروع OpenITI برخصة CC BY-NC-SA 4.0 (لغير الأغراض التجارية، مع ذكر المصدر، وبالرخصة نفسها)، ونص القرآن من Tanzil (يُنقل كما هو مع ذكر المصدر)، ومقالات البيان تُنقل مع ذكر المصدر والرابط.",
  "limits": "120 طلبًا في الدقيقة و5000 في اليوم لكل عنوان IP. إذا كان الخادم مشغولًا يأتي الرد 503 مع Retry-After: أعد المحاولة بعد ثوانٍ. الآيات والأحاديث تُحفظ يومًا، وقوائم المقالات عشر دقائق.",
  "endpoints": [
    {
      "path": "/api/articles",
      "description": "أحدث المقالات والأجوبة المنشورة (٢٠ في الصفحة)؛ ?page=2 ، ?category=hadith",
      "example": "https://bayan.alwa7i.com/api/articles"
    },
    {
      "path": "/api/articles/{slug}",
      "description": "مقالة كاملة: العنوان والملخص والنص (HTML ونصًّا خامًا)",
      "example": "https://bayan.alwa7i.com/api/articles/{slug}"
    },
    {
      "path": "/api/quran/{surah}/{ayah}",
      "description": "الآية مع مقاطع تفسيرها من كتب التفسير",
      "example": "https://bayan.alwa7i.com/api/quran/2/255"
    },
    {
      "path": "/api/hadith/{book}?number={رقم الحديث}",
      "description": "الحديث برقمه في الكتاب كما يُعزى إليه (البخاري ح ١): نصه ودرجته ورواته وتخريجه. الكتب: sabil-al-rashad، sahih-al-bukhari، sahih-muslim، sunan-abi-dawud، jami-al-tirmidhi، sunan-al-nasai، sunan-ibn-majah، musnad-ahmad، al-muwatta",
      "example": "https://bayan.alwa7i.com/api/hadith/sahih-al-bukhari?number=1"
    },
    {
      "path": "/api/hadith/{book}/{seq}",
      "description": "الحديث بموضعه في الكتاب (الرقم الذي في روابط الموقع /hadith/{book}/{seq})؛ المقدمات والتراجم بلا رقم حديث",
      "example": "https://bayan.alwa7i.com/api/hadith/sahih-al-bukhari/3"
    },
    {
      "path": "/api/narrator?name={الاسم}",
      "description": "الراوي: رابط صفحته (فيها مرتبته وأقوال أئمة الجرح والتعديل فيه) ومقالات البيان عنه",
      "example": "https://bayan.alwa7i.com/api/narrator?name=خالد بن معدان"
    },
    {
      "path": "/api/search?q={كلمات}",
      "description": "بحث: آيات وأحاديث (سبيل الرشاد والصحيحان) ومقالات فيها هذه الكلمات، مع روابطها",
      "example": "https://bayan.alwa7i.com/api/search?q=إنما الأعمال بالنيات"
    },
    {
      "path": "/feed.xml",
      "description": "خلاصة RSS للمقالات والأجوبة المنشورة",
      "example": "https://bayan.alwa7i.com/feed.xml"
    }
  ],
  "categories": [
    {
      "slug": "tawhid",
      "ar": "التوحيد",
      "en": "Tawhid"
    },
    {
      "slug": "fiqh",
      "ar": "الفقه",
      "en": "Fiqh"
    },
    {
      "slug": "seerah",
      "ar": "السيرة",
      "en": "Seerah"
    },
    {
      "slug": "tafsir",
      "ar": "التفسير",
      "en": "Tafsir"
    },
    {
      "slug": "quran-sciences",
      "ar": "علوم القرآن",
      "en": "Qur'anic sciences"
    },
    {
      "slug": "hadith",
      "ar": "الحديث",
      "en": "Hadith"
    },
    {
      "slug": "akhlaq",
      "ar": "الأخلاق",
      "en": "Akhlaq"
    },
    {
      "slug": "ashrat",
      "ar": "أشراط الساعة",
      "en": "Signs of the Hour"
    },
    {
      "slug": "english",
      "ar": "English",
      "en": "English"
    }
  ]
}