توثيق بوابة التعريف بالإسلام “بلاغ”
مقدمة:
تعد بوابة "بلاغ" من البوابات المتميزة والفريدة في موقع IslamHouse.com ، حيث أن هذه البوابة موجهة إلى كل من يريد التعريف بالإسلام لأصدقاءه من غير المسلمين بأي لغة كانت دون الحاجة لإجادة لغات أصدقاءه!؛ إذ يمكنه من خلال بوابة "بلاغ" التعرف على مجموعة من المواد المناسبة والمختصة بالتعريف بالإسلام بأحد اللغات المتوفرة، ثم إرسال روابط تلك المواد عبر البريد الإلكتروني أو المواقع الإجتماعية إلى أصدقاءه الذين يتحدثون بتلك اللغات عبر البوابة!. فعلى سبيل المثال: شخص عربي لديه زميل عمل فرنسي، ويريد زميله الفرنسي التعرف على الإسلام وهو لا يجيد إلا اللغة العربية، فيمكنه ذلك من خلال بوابة "بلاغ" بتصفح المواد الفرنسية المختصة بالتعريف بالإسلام، ثم اختيار البعض منها، ثم إرسالها إلى زميله الفرنسي عبر بريده الإلكتروني، فتصل زميله الفرنسي رسالة باللغة الفرنسية - معدة سلفًا في نظام بوابة "بلاغ" - وفيها إفادة بأن أحد أصدقاءه يقترح عليه الاطلاع على هذه المواد الفرنسية !.
يمكنك تصفح البوابة على الرابط التالي:
بلاغ.
:مكونات البنية التحتية لبوابة “بلاغ”
جميع الروابط الخاصة ببوابة بلاغ تبدأ بالرابط التالي:
http://api.islamhouse.com/v1/XXXXXX/dynamic/balagh/
جلب مواد اللغات المتوفرة بلغة واجهة تعريفية معينة:
لجلب مواد اللغات المتوفرة في بوابة “بلاغ” وبواجهة عربية مثلًا فيمكنك طلب الرابط التالي:
http://api.islamhouse.com/v1/XXXXXXXX/dynamic/balagh/get-all/ar/json
والتكوين البرمجي للرابط هو:
/get-all/{lang}/{format}
ولمعرفة لغات الواجهات التعريفية المتوفرة والتي يمكن تصفح مواد اللغات بها فيمكنك طلب الرابط التالي:
http://api.islamhouse.com/v1/XXXXXXXX/dynamic/balagh/get-available-languages/json
جلب محتويات لغة معينة وبواجهة تعريفية معينة:
لجلب مواد لغة معينة وبواجهة لغة معينة فيم طلب الرابط التالي:
http://api.islamhouse.com/v1/XXXXXXXX/dynamic/balagh/get-content-by-type/showall/ar/showall/1/3/json
والتكوين البرمجي للرابط السابق هو:
/get-content-by-type/{type}/{flang}/{slang}/{pageNum}/{limit}/{format}
ملاحظات هامة:
في المثال السابق هناك مجموعة من المتغيرات تم إدخالها للرابط وهي:
type flang slang pageNum limit format
type: تمثل نوع المواد التي تريد جلبها حيث يمكنك تحديد نوع بعينه.
ولمعرفة الأنواع المتاحة يمكن طلب الرابط التالي:
http://api.islamhouse.com/v1/XXXXXXXXX/dynamic/balagh/get-available-types/ar/ar/jsonوالتكوين البرمجي للرابط هو:
/get-available-types/{flang}/{slang}/{format}
حيث أن المتغير flang يمثل لغة الواجهة التعريفية للمواد التي تريد جلبها.
والمتغير slang يمثل لغة محتوى المواد التي تريد جلبها.
pageNum: تمثل رقم الصفحة التي تريد عرضها، وغالبا تبدأ بالرقم 1 لجلب محتويات الصفحة الأولى.
معلومة:
في لغة المصدر يمكنك إستخدام الكلمة showall بدلا من رمز اللغة؛ لجلب جميع اللغات دون تحديد لغة بعينها؛ فعلى سبيل المثال: إذا أردنا جلب جميع الأنواع المتاحة للغة الواجهة العربية وبأي لغة محتوى فاطلب الرابط التالي: >br />
http://api.islamhouse.com/v1/XXXXXXXXX/dynamic/balagh/get-available-types/ar/showall/jsonلاحظ تغيير رمز اللغة من ar إلى .showall لتكون النتيجة:
[ "books", "articles", "audios", "videos", "fatwa", "poster", "programsv", "apps", "cards" ]>br />
ولجلب جميع المواد بواجهة عربية وبأي لغة محتوى مع عدم تحديد نوع معين فاطلب الرابط التالي:
http://api.islamhouse.com/v1/XXXXXXX/dynamic/balagh/get-content-by-type/showall/ar/showall/1/3/json>br /> لاحظ أننا استخدمنا كلمة showall في موضعين: في الأنواع كالكتب والصوتيات والمقالات .. الخ، وفي لغة محتوى المواد كالإنجليزية والفرنسية والإسبانية .. الخ، وغالبًا هذا الأسلوب معتمد في كل روابط البنية التحتية في بوابة البيانات API لموقع دار الإسلام. والتكوين البرمجي للرابط السابق هو:
/get-content-by-type/{type}/{flang}/{slang}/{pageNum}/{limit}/{format}
مع ملاحظة أنه تم تحديد العدد المطلوب جلبه بـ 3 عناصر فقط، والحد الأقصى للعدد في كل صفحة هو 50 عنصرًا فقط.
>br />مثال عملي:
{
links: {
next: "http://api.islamhouse.app:8000/v1/XXXXXXX/dynamic/balagh/get-content-by-type/showall/ar/showall/2/3/json/",
prev: "",
first: "http://api.islamhouse.app:8000/v1/XXXXXXX/dynamic/balagh/get-content-by-type/showall/ar/showall/1/3/json/",
last: "http://api.islamhouse.app:8000/v1/XXXXXXX/dynamic/balagh/get-content-by-type/showall/ar/showall/462/3/json/",
current_page: 1,
pages_number: 462,
total_items: 1384
},
data: [
{
id: 814355,
source_id: 814354,
title: "الظلم وأداء الحقوق في الإسلام",
description: "محاضرة بلغة الموري، وفيها بيان ما يلي: • حق الله - عز وجل - على عباده. • حقوق الرسول - صلى الله عليه وسلم -. • حقوق الوالدين. • حقوق الأقارب. • بيان بعض أنواع الظلم. • الكهانة وشركيتها. • التحذير من الأخلاق السيئة.",
full_description: null,
add_date: 1424284490,
type: "audios",
image: null,
prepared_by: [
{
id: 807457,
source_id: 807457,
title: "سليمان كندو",
kind: "author",
type: "author",
description: "من مشايخ الدعوة التابعين لجمعية أهل السنة ببوركينا فاسو."
},
{
id: 801768,
source_id: 801768,
title: "حسين ويدراوغو",
kind: "reviewer",
type: "author",
description: "طالب ماجستير بقسم الآداب، بجامعة الملك سعود."
}
],
attachments: [
{
order: 1,
size: "24.4 MB",
extension_type: "MP3",
description: "wẽgdo la hakε-rãmb kũunĩ lihlaangã pʋgẽ",
url: "http://d1.islamhouse.app/data/mos/ih_sounds/single/mos_wegdo_la_hake_ramb_kuuni_lihlaanga_puge.mp3"
}
],
api_url: "http://api.islamhouse.app:8000/v1/XXXXXXX/dynamic/balagh/get-item/814354/ar/json/"
},
{
id: 813501,
source_id: 813500,
title: "ما هو الإسلام ؟ - الجزء الأول -",
description: "مقالة بلغة الموري تحدث الكاتب فيها عن الهدف من حياة الإنسان على الأرض، والهدف من خلق الله الإنسان، وتمييزه بالعقل والعلم، وتكريمه له، ورسالة الإنسان في الأرض، وإرسال الله للرسل بالكتب والأديان إلى الإنسان لهدايته، وختم الله الدين في الأرض برسول الإسلام، وأشار إلى جمال الإسلام وما يتضمنه من أخلاق. والمقالة القادمة ستقدم تفصيلا أكثر عن الإسلام.",
full_description: null,
add_date: 1424093829,
type: "articles",
image: null,
prepared_by: [
{
id: 801768,
source_id: 801768,
title: "حسين ويدراوغو",
kind: "author",
type: "author",
description: "طالب ماجستير بقسم الآداب، بجامعة الملك سعود."
},
{
id: 8636,
source_id: 8636,
title: "المكتب التعاوني للدعوة وتوعية الجاليات بالربوة",
kind: "source",
type: "source",
description: "مؤسسة خيرية دعوية قائمة على جهود المحتسبين وتبرعات المحسنين، وقد أسس بتوجيه من سماحة الشيخ العلامة عبد العزيز بن عبد الله بن باز مفتي عام المملكة العربية السعودية - رحمه الله تعالى -، وذلك في الثلاثاء الموافق الثامن والعشرين من الشهر الثامن لعام أربعة عشر وأربعمائة وألف للهجرة النبوية على صاحبها أفضل الصلاة وأتم التسليم، والمكتب يعمل تحت إشراف وزارة الشؤون الإسلامية والأوقاف والدعوة والإرشاد."
}
],
attachments: [
{
order: 1,
size: "272 KB",
extension_type: "PDF",
description: "Yaa bõe la tũudm-sor laning b sẽn boond tɩ Moemdã?(1)",
url: "http://d1.islamhouse.app/data/mos/ih_articles/chain/what_is_islam/mos_Yaa_b_e_meg_la_t_udm.pdf"
},
{
order: 2,
size: "3.6 MB",
extension_type: "DOCX",
description: "Yaa bõe la tũudm-sor laning b sẽn boond tɩ Moemdã?(1)",
url: "http://d1.islamhouse.app/data/mos/ih_articles/chain/what_is_islam/mos_Yaa_b_e_meg_la_t_udm.docx"
}
],
api_url: "http://api.islamhouse.app:8000/v1/XXXXXXX/dynamic/balagh/get-item/813500/ar/json/"
},
{
id: 809178,
source_id: 809177,
title: "وسطية الإسلام",
description: "محاضرة باللغة البامبارية، وفيها بيان وسطية الإسلام، فهو وسط في أخذ الحقوق والعطاء، وسط في العقيدة، وسط في العبادة، وسط في الشرائع، ووسط في الواجبات.",
full_description: null,
add_date: 1422469589,
type: "audios",
image: null,
prepared_by: [
{
id: 678933,
source_id: 678933,
title: "عثمان صالح تراروي",
kind: "author",
type: "author",
description: "خريج الجامعة الإسلامية في النيجير، وهو إمام وخطيب وداعية، ونائب لرئيس رابطة الدعاة في مالي، وعضو المجلس الأعلى الإسلامي."
},
{
id: 678934,
source_id: 678934,
title: "صديق جنتا",
kind: "reviewer",
type: "author",
description: "صديق جنتا : خريج من كلية الشريعة وطالب في المعهد العالي للقضاء (الماجستير) في جامعة الامام محمد بن سعود الاسلامية ، ومشرف على لغة بامبارا في موقع دار الإسلام وإمام وخطيب وداعية."
}
],
attachments: [
{
order: 1,
size: "16.4 MB",
extension_type: "MP3",
description: "Silameya ye TiemanTie Dine ye",
url: "http://d1.islamhouse.app/data/bm/ih_sounds/single/bm_Silameya_ye_TiemanTie_Dine_ye.mp3"
}
],
api_url: "http://api.islamhouse.app:8000/v1/XXXXXXX/dynamic/balagh/get-item/809177/ar/json/"
}
]
}
في المثال السابق سوف تجد متغيرات هامة تساعدك في تنظيم عملية تعدد الصفحات؛ حيث يتم توضيح رقم الصفحة الحالية، وعدد الصفحات للنتيجة، وكذلك إجمالي عدد العناصر.
أمثلة عامة:
تجربة جلب الصوتيات فقط للمواد العربية وبواجهة تعريفية عربية:
http://api.islamhouse.com/v1/XXXXXXXX/dynamic/balagh/get-content-by-type/audios/ar/ar/1/50/json
تجربة جلب الصوتيات فقط لجميع اللغات وبواجهة تعريفية عربية:
http://api.islamhouse.com/v1/XXXXXXXX/dynamic/balagh/get-content-by-type/audios/ar/showall/1/50/json
تجربة جلب الكتب فقط لجميع اللغات وبواجهة تعريفية عربية:
http://api.islamhouse.com/v1/XXXXXXXX/dynamic/balagh/get-content-by-type/books/ar/showall/1/50/json
تجربة جلب الصوتيات فقط للمواد الروسية وبواجهة تعريفية عربية:
http://api.islamhouse.com/v1/XXXXXXXX/dynamic/balagh/get-content-by-type/books/ar/showall/1/50/json
خدمة الرابط الموحد لمجموعة مواد:
>br />في بعض الحالات تحتاج أن ترسل مجموعة كبيرة من المواد منتقاة وبرابط واحد إلى مستفيد معين، وتريد أن تختصر عدد الروابط والبيانات الكثيرة لكي يتم إرسالها من خلال الشبكات الإجتماعية أو البريد .. يمكنك أن تحصل على هذه الخدمة من خلال إرسال POST request إلى الرابط التالي:
http://api.islamhouse.com/v1/XXXXXXX/dynamic/balagh/get-share-id/json
ملاحظة هامة:
يجب أن يكون المتغير المرسل باسم data ويكون على هيئة مصفوفة json ويحتوي على المتغيرات التالية:
shareon: وهو الحقل الخاص لطريقة المشاركة ( فيس بوك - جوجل بلس - بريد - تويتر ) ويرمز لها بالرموز (f-g-m-t) ويجب الالتزام بهذه الحروف الصغيرة وعدم استخدام حروف أخرى!. sender_name: اسم المرسل . sender_email: بريد المُرسِل. to_name: اسم الشخص المُرسَل إليه. to_email: بريد الشخص المُرسَل إليه. slang: لغة محتوى المادة المُرسلة. items: وهي عبارة عن متغير آخر من نوع مصفوفة يحتوي على source_id الخاص بالعناصر المُرسلة.
مثال على المصفوفة بلغة الـ php:
$data = array(
'shareon' => 'm',
'sender_name' => 'Test Name',
'sender_email' => 'Test Email',
'to_name' => 'Receiver Name',
'to_email' => 'Receiver Email',
'slang' => 'ar',
'items' => array(
23121321 ,
321212112,
2312113,
564464564
)
);
مثال على المصفوفة بعد تحويلها إلى json:
{
"shareon":"m",
"sender_name":"Test",
"sender_email":"[email protected]",
"to_name":"Receiver Name",
"to_email":"[email protected]",
"slang":"ar",
"items":[
323296,
311867,
1883
]
}
وهذا هو شكل البيانات المرسلة حيث يجب أن تكون البيناات على هيئة json.
وعند إرسال البيانات كما تم توضيحه آنفًا يكون الرد على هيئة json بـ share_id فعلى سبيل المثال:
{
"share_id": "ldezw80d9cslv4ji99uh"
}
وعند حصولك على الـ id الخاصة بهذه العملية يمكنك استخدامه بأكثر من طريقة؛ فمثلًا: لعرض المواد التي تم تجميعها يتم إستخدام الرابط التالي:
http://balagh.islamhouse.com/ar/share-show/ldezw80d9cslv4ji99uh/
فالرابط السابق هو الرابط الذي يتم مشاركته او إرساله عبر البريد الإلكتروني، وعند فتحه يتم استعراض جميع المواد المندرجة تحته.
وفي حالة إذا أردت أن تقوم بتصميم صفحتك الخاصة أو تصميم طريقة عرضك الخاصة يمكنك أن تُرسل الـ id إلى البوابة لكي ترد عليك بالتفاصيل كمثل:
http://api.islamhouse.com/v1/XXXXXXXX/dynamic/balagh/get-share-items/ldezw80d9cslv4ji99uh/jsonوتكون النتجية كالتالي :
{
id: "ldezw80d9cslv4ji99uh",
shareon: "m",
sender_name: "ماهر الجميل",
sender_email: "[email protected]",
to_name: "Maher ",
to_email: "[email protected]",
slang: "ar",
add_date: 1441242140,
items: [
{
id: 462850,
source_id: 462850,
title: "هذا هو الإسلام",
description: "محاضرةٌ قيِّمة للشيخ العلامة صالح بن عبد العزيز آل الشيخ - حفظه الله -، وقد تناولت موضوع: «هذا هو الإسلام» من عدة عناصر، وهي: هذا هو الإسلام: في العقيدة والعبادات، وفي الشريعة، وفي نظام الحكم، وفي الأخلاق، وفي الاقتصاد والمال، وفي الاجتماع والألفة والافتراق، وفي العلاقات الدولية، وفي المدنية، وفي الخلاف والحوار، وفي المذاهب والأحزاب، وفي الوسطية والاعتدال والتحذير من الغلو، فخرجت شاملةً لكل أصول الدين وفروعه باختصار.",
full_description: "",
type: "books",
add_date: 1393429153,
orginal_item: "yes",
translation_language: "ar",
source_language: "ar",
image: null,
prepared_by: [
{
id: 7799,
source_id: 7799,
title: "صالح بن عبد العزيز آل الشيخ",
type: "author",
kind: "author",
description: "هو معالي الشيخ صالح بن عبد العزيز بن محمد بن إبراهيم آل الشيخ، وزير الشؤون الإسلامية والأوقاف والدعوة والإرشاد بالمملكة العربية السعودية - حرسها الله بالإسلام -."
},
{
id: 179366,
source_id: 179366,
title: "موقع طريق الإسلام www.islamway.net",
type: "source",
kind: "source",
description: "موقع طريق الإسلام www.islamway.net من أكبر المواقع الإسلامية في مجال الصوتيات، حيث يحتوي على أكثر من 80000 مادة صوتية لأكثر من خمسمائة شيخ وعالم وداعية وأكثر من 200 مصحف صوتي، فضلًا عن قسم للكتب والمقالات ... إلخ."
}
],
attachments: [
{
order: 1,
size: "354 KB",
extension_type: "PDF",
description: "هذا هو الإسلام",
url: "http://d1.islamhouse.app/data/ar/ih_books/single8/ar_this_is_islam.pdf"
},
{
order: 2,
size: "327.5 KB",
extension_type: "DOC",
description: "هذا هو الإسلام",
url: "http://d1.islamhouse.app/data/ar/ih_books/single8/ar_this_is_islam.doc"
}
],
locales: [
"ar",
"zh",
"en",
"id",
"am",
"ta",
"ti",
"aa",
"ml"
],
locales-types: [
{
locale: "ar",
type: "books"
},
{
locale: "zh",
type: "books"
},
{
locale: "en",
type: "books"
},
{
locale: "id",
type: "books"
},
{
locale: "am",
type: "books"
},
{
locale: "ta",
type: "books"
},
{
locale: "ti",
type: "books"
},
{
locale: "aa",
type: "books"
},
{
locale: "ml",
type: "books"
}
]
},
{
id: 551773,
source_id: 551773,
title: "لماذا اعتنقنا الإسلام دينًا؟",
description: "كتاب يحتوي على أروع القصص لنخبةٍ من رجال الفكر والقانون والعلوم الأخرى في مختلف أقطار العالم، قديمًا وحديثًا، وسبب اعتناقهم الإسلام.",
full_description: "",
type: "books",
add_date: 1398643010,
orginal_item: "yes",
translation_language: "ar",
source_language: "ar",
image: null,
prepared_by: [
{
id: 551772,
source_id: 551772,
title: "سفر أحمد الحمداني",
type: "author",
kind: "author",
description: "داعية عراقي، وهو إمام وخطيب جامع الحسن بن علي في كربلاء."
},
{
id: 166510,
source_id: 166510,
title: "شبكة الألوكة www.alukah.net",
type: "source",
kind: "source",
description: "موقع غنيٌّ شامل؛ إعلاميُّ، وثقافيٌّ، وعلميٌّ، وأدبيٌّ يشارك فيه نخبةٌ من أهل العلم والفكر والدَّعوة، بإشراف الشيخ الدكتور سعد الحميد والدكتور خالد الجريسي."
}
],
attachments: [
{
order: 1,
size: "1.5 MB",
extension_type: "PDF",
description: "لماذا اعتنقنا الإسلام دينًا؟",
url: "http://d1.islamhouse.app/data/ar/ih_books/single8/ar_Why_embraced_Islam_as_a_religion.pdf"
}
],
locales: [
"ar",
"tr",
"en",
"id",
"th",
"am",
"aa",
"ml"
],
locales-types: [
{
locale: "ar",
type: "books"
},
{
locale: "tr",
type: "books"
},
{
locale: "en",
type: "books"
},
{
locale: "id",
type: "books"
},
{
locale: "th",
type: "books"
},
{
locale: "am",
type: "books"
},
{
locale: "aa",
type: "books"
},
{
locale: "ml",
type: "books"
}
]
},
{
id: 794361,
source_id: 794361,
title: "أصول الدين الإسلامي",
description: "كتاب أصول الدين الإسلامي لشيخ الإسلام محمد بن سليمان التميمي - رحمه الله - وقد رتب هذا الكتاب على طريقة السؤال والجواب فضيلة الشيخ محمد الطيب الأنصارى المدني - أثابه الله - ويحتوى هذا الكتاب على أهم المسائل فى الدين الإسلامى.",
full_description: "",
type: "books",
add_date: 1418045356,
orginal_item: "yes",
translation_language: "ar",
source_language: "ar",
image: null,
prepared_by: [
{
id: 144965,
source_id: 144965,
title: "محمد الطيب بن إسحاق الأنصاري المدني",
type: "author",
kind: "author",
description: "- ولد الشيخ محمد الطيب بن إسحاق الأنصاري في بلدة تنبكتو بمنطقة المراقد في الصحراء الكبرى الإفريقية عام 1296هـ، وفيها نشأ وتربى، ولما بلغ الثامنة من عمره توفي والده، فكفله جماعة من أقاربه، فحفظ القرآن الكريم، وتلقى العلم في حلقات التدريس على علماء بلده. - وفي عام 1323هـ هاجر إلى المدينة المنورة، ومنها انتقل إلى مكة المكرمة متفرغاً للعبادة والزهد، وتلاوة القرآن، ومطالعة العلوم الشرعية والعربية، ولم يطل به المقام حتى عاد إلى المدينة المنورة ليستقر فيها، ويشارك في التدريس في حلقات المسجد النبوي الشريف، يدرس العلوم العربية، والفقه، والتفسير، وفي عام 1341هـ عين رئيساً لمدرسي المسجد النبوي. - التحق بمدرسة العلوم الشرعية، وتولى رئاسة مدرسيها بناء على طلب مؤسسها والمسؤول عنها السيد أحمد الفيض آبادي، وظل يشتغل بالتدريس والتأليف حتى وفاته سنة 1362هـ فدفن بالبقيع، وصلي عليه صلاة الغائب في المسجد الحرام، وفي المسجد الكبير بالرياض. - مؤلفاته: ـ الدرة الثمينة في النحو، نظم فيها شذور الذهب لابن هشام. ـ اللآلئ الثمينة في شرح الدرة الثمينة. ـ تحبير التحرير في اختصار تفسير الإمام ابن جرير. ـ التحفة البكرية في نظم الشافعية. ـ السراج الوهاج في اختصار صحيح مسلم بن الحجاج. ـ البراهين الموضحات في نظم كشف الشبهات. "
},
{
id: 8674,
source_id: 8674,
title: "الرئاسة العامة للبحوث العلمية والإفتاء بالرياض www.alifta.com",
type: "source",
kind: "source",
description: null
}
],
attachments: [
{
order: 1,
size: "1.7 MB",
extension_type: "PDF",
description: "أصول الدين الإسلامي",
url: "http://d1.islamhouse.app/data/ar/ih_books/single9/ar_asol_eldeen_elaslamy.pdf"
}
],
locales: [
"ar",
"id",
"am",
"ti",
"aa",
"ml"
],
locales-types: [
{
locale: "ar",
type: "books"
},
{
locale: "id",
type: "books"
},
{
locale: "am",
type: "books"
},
{
locale: "ti",
type: "books"
},
{
locale: "aa",
type: "books"
},
{
locale: "ml",
type: "books"
}
]
}
]
}