الكتب

تضم المكتبة أكثر من 300 كتاب. لكل كتاب إصدار عربي أو أكثر، وترجمات تصل إلى 64 لغة، وملفات PDF وWord.

الفهرس

GET/books

المعامل	الحالة	الوصف
lang	اختياري	يضيف translated_title وtranslated_description للكتب المترجمة إلى هذه اللغة.

يعرض هذا المسار جميع الكتب المنشورة، مع إصداراتها واللغات المتاحة لكل إصدار. يبلغ حجم الاستجابة نحو 800 كيلوبايت، لذا يُنصح بتخزينها مؤقتًا في تطبيقك.

curl "https://islamenc.com/api/books?lang=en"

[
  {
    "project_id": 36,
    "title": "الأصول الثلاثة وأدلتها",
    "name": "الأصول الثلاثة وأدلتها",
    "description": "...",
    "is_hidden": false,
    "versions": [
      {
        "id": 3702,
        "version_number": "2.00",
        "version_name": "2.0",
        "is_latest": true,
        "translations": [
          { "id": 17308, "language": { "isoCode": "fr", "englishName": "French", "nativeName": "Français", "direction": "ltr" }, "version_number": 1, "source": "molhem" }
        ]
      }
    ],
    "available_languages": ["ar", "en", "fr", "..."],
    "language_count": 64,
    "translated_title": "The Three Fundamental Principles",
    "translated_description": "..."
  }
]

يعرض available_languages وlanguage_count اللغات المتاحة وعددها للإصدار الأحدث. ويحدد source مصدر الترجمة (molhem، islamhouse…).

كتاب واحد

GET/books/{projectId}

يعرض بيانات الكتاب وإصداراته وترجماته، كما في الفهرس، ويضيف ملفات PDF وWord:

{
  "project_id": 36,
  "title": "الأصول الثلاثة وأدلتها",
  "versions": [ ... ],
  "pdfs": [
    { "id": 383, "project_id": 36, "lang": "af", "version_name": "2.0", "source": "molhem", "url": "https://islamenc-files.hel1.your-objectstorage.com/pdf/36/af-2.0.pdf", "bytes": 412433, "updated_at": "2026-10-02T09:11:40.000Z" }
  ],
  "docxs": [
    { "id": 120, "project_id": 36, "lang": "af", "version_name": "2.0", "url": "https://islamenc-files.hel1.your-objectstorage.com/docx/36/af-2.0.docx", "bytes": 98311, "updated_at": "2026-10-12T02:30:11.000Z" }
  ]
}

روابط url عامة ومباشرة. يمكنك استخدامها لعرض روابط الملفات أو تنزيلها. إذا أُزيل الكتاب من النشر، يُرجع المسار استجابة فارغة.

نص إصدار

GET/books/{projectId}/versions/{versionName}

يعرض النص العربي لإصدار واحد، مقسّمًا إلى فصول وعبارات مرتبة حسب تسلسل القراءة. استخدم قيمة version_name من الفهرس، مثل 2.0، في versionName.

curl "https://islamenc.com/api/books/36/versions/2.0"

[
  {
    "id": 7283,
    "serial": 1,
    "name": "الأصول الثلاثة وأدلتها",
    "phrases": [
      {
        "phrase_id": "21fd289f-c28c-458b-bae3-d8f5741da543",
        "group_id": 360,
        "group_order": 10,
        "arabic_text": "(اعلم) رحمك الله أنه يجب على كل مسلم ومسلمة تعلم هذه الثلاث مسائل والعمل بهن.",
        "text_type": "p",
        "content_type_id": 4,
        "tag": "p",
        "hadith_card_id": null,
        "hadith_match_score": null,
        "hadith_link_source": null,
        "links": []
      }
    ]
  }
]

الحقل	المعنى
group_id، group_order	group_id رقم الفقرة، وgroup_order ترتيب العبارة داخلها. اجمع عبارات الفقرة الواحدة لتعيد بناءها.
tag	نوع العبارة بأسماء وسوم HTML: p، h1…h4، li، blockquote. وtext_type المعلومة نفسها بمسميات المصدر.
content_type_id	نوع النص: 1 عنوان، 4 متن، وأنواع للحواشي والعناوين.
hadith_card_id	حين تقتبس العبارة حديثًا موجودًا في موسوعة الأحاديث: معرّف بطاقته external_id، مع درجة المطابقة وطريقة إيجادها.
links	روابط داخلية اكتشفها الموقع في هذه العبارة. فارغة في أغلب العبارات.

ترجمة

GET/books/{projectId}/translations/{isoCode}

يعرض ترجمة الكتاب بلغة واحدة، مع النص العربي المقابل لكل عبارة. استخدم في isoCode رمز لغة من GET /books/{projectId}/languages.

curl "https://islamenc.com/api/books/36/translations/fr"

[
  {
    "id": 17308,
    "arabicVersion": { "id": 3702, "version_number": "2.00", "version_name": "2.0", "is_latest": true },
    "language": { "isoCode": "fr", "englishName": "French", "nativeName": "Français", "direction": "ltr" },
    "version_number": 1,
    "source": "molhem",
    "phrases": [
      {
        "id": 7033944,
        "phrase": {
          "phrase_id": "fee0fb72-8ccb-4aac-80bb-cc7e872d9ea1",
          "chapter": { "id": 7285, "serial": 2, "name": "ثلاثة الأصول وأدلتها" },
          "group_id": 55,
          "group_order": 3,
          "arabic_text": "[آل عمران: 18]"
        },
        "translated_text": "[Âl ‘Imrân : 18]"
      }
    ]
  }
]

تحتوي الاستجابة على عنصر لكل إصدار عربي له ترجمة باللغة المطلوبة، ويكون عادةً الإصدار الأحدث. اجمع العبارات بحسب phrase.chapter ثم phrase.group_id لتعرض الفصول والفقرات بالترتيب نفسه في العربية.

لغات كتاب

GET/books/{projectId}/languages

["aa", "af", "ak", "am", "as", "en", "fr", "..."]

كل ملفات PDF

GET/books/pdfs

يعرض ملفات المكتبة كاملة، في سجل مستقل لكل كتاب ولغة وإصدار. تضم الاستجابة نحو 2,900 سجل بحجم 800 كيلوبايت. يمكن استخدامها لإنشاء خريطة موقع أو تنزيل نسخة كاملة.

[
  { "project_id": 36, "lang": "fr", "version_name": "2.0", "source": "molhem", "bytes": 466120, "url": "https://islamenc-files.hel1.your-objectstorage.com/pdf/36/fr-2.0.pdf", "updated_at": "2026-10-02T09:11:40.000Z", "title": "Les trois fondements" }
]

title عنوان الكتاب بتلك اللغة، ويُستحسن حفظ الملف بهذا الاسم.