dorar hadith api下載 - dorar hadith api原始碼下載

Dorar.net 聖訓 API

願上帝的平安、祝福和憐憫臨到你

不久前我嘗試使用 Dental Pearls API
但我遇到了一些困難，包括API只處理JSONP，由於CORS，你將無法以正常方式處理它。

如果您透過使用JSONP成功documentation CORS ， API將獲得HTML格式的輸出。

我決定建立一個中間API ，它可以避免CORS問題，並為您提供JSON格式的資料以及該API的詳細說明以及如何使用它
除了包含一些官方API中沒有的附加功能之外

警報

每次搜尋都會cache 5秒
有使用限制：每個IP每天100搜索

您可以從 config.js 檔案編輯它們

運行API

fork或clone此項目
安裝dependencies

npm install

檢查config.js檔案並修改你想要的內容
運行API

npm start

該API將在以下連結中提供

http://localhost:5000

根據需要在localhost上使用它，或將其上傳到您自己的主機或伺服器

文件

郵差

連結：郵差

使用Postman了解如何使用API並查看範例
fork collection以按照您的意願使用它
不要忘記將environment更改為dev如果您更改了變數{{url}}或更改了port

OpenAPI v3（招搖）

API文件

查看互動式API文件：

運行伺服器：
```
 npm run dev
```
打開瀏覽器並轉到：
```
 http://localhost:5000/api-docs
```

在這裡，您將找到 Swagger UI，它允許您探索所有可用端點並直接從瀏覽器測試 API。

端點

API包含一組endpoint

當endpoint以/api開頭時，它會搜尋官方 Durar Al-Suniya API
當endpoint以/site開頭時，這就是透過 Durar Al-Sunniyya 搜尋頁面搜尋它的方式

/v1/api/hadith/search?value={文本}

搜尋聖訓給15結果

將響應格式化為JSON

{
  "metadata" : {
    "length" : " عدد نتائج البحث " ,
    "page" : " رقم الصفحة " ,
    "removeHTML" : " هل عناصر الـ HTML ممسوحة أم لا " ,
    "isCached" : " هل هذه النتائج من الـ cache أم لا "
  },
  "data" : [
    {
      "hadith" : " الحديث " ,
      "rawi" : " الراوي " ,
      "mohdith" : " المحدث " ,
      "book" : " الكتاب " ,
      "numberOrPage" : " رقم الحديث او الصفحة " ,
      "grade" : " درجة الصحة "
    }
  ]
}

/v1/site/hadith/search?value={text}

搜尋聖訓給予30結果

將響應格式化為JSON

{
  "metadata" : {
    "length" : " عدد نتائج البحث " ,
    "page" : " رقم الصفحة " ,
    "removeHTML" : " هل عناصر الـ HTML ممسوحة أم لا " ,
    "specialist" : " نوع الاحاديث هل هي للمتخصصين أم لا " ,
    "numberOfNonSpecialist" : " عدد الأحاديث لغير المتخصصين " ,
    "numberOfSpecialist" : " عدد الأحاديث للمتخصصين " ,
    "isCached" : " هل هذه النتائج من الـ cache أم لا "
  },
  "data" : [
    {
      "hadith" : " الحديث " ,
      "rawi" : " الراوي " ,
      "mohdith" : " المحدث " ,
      "mohdithId" : " رقم المحدث " ,
      "book" : " الكتاب " ,
      "bookId" : " رقم الكتاب " ,
      "numberOrPage" : " رقم الحديث او الصفحة " ,
      "grade" : " درجة الصحة " ,
      "explainGrade" : " توضيح درجة الصحة " ,
      "takhrij" : " تخريج الحديث في كتب أخرى " ,
      "hadithId" : " رقم الحديث لاستخدامه في البحث عن الأحاديث البديلة أو الحديث البديل الصحيح " ,
      "hasSimilarHadith" : " هل الحديث له أحاديث مشابهة أم لا " ,
      "hasAlternateHadithSahih" : " هل الحديث له حديث صحيح بديل أم لا " ,
      "similarHadithDorar" : " رابط الأحاديث المشابهة في موقع الدرر " ,
      "alternateHadithSahihDorar" : " رابط الحديث الصحيح في موقع الدرر " ,
      "urlToGetSimilarHadith" : " رابط لكي تبحث عن الأحاديث المشابهة " ,
      "urlToGetAlternateHadithSahih" : " رابط لكي تبحث عن الحديث الصحيح " ,
      "hasSharhMetadata" : " هل الحديث له شرح أم لا " ,
      "sharhMetadata" : {
        "id" : " رقم الشرح " ,
        "isContainSharh" : " هل يحتوى هذا الرد على شرح الحديث أم لا؟ " ,
        "urlToGetSharh" : " رابط لكي تبحث عن شرح الحديث "
      }
    }
  ]
}

/v1/site/hadith/similar/:id

為您帶來與id對應的相似對話

將響應格式化為JSON

{
  "metadata" : {
    "length" : " عدد نتائج البحث " ,
    "isCached" : " هل هذه النتائج من الـ cache أم لا "
  },
  "data" : [
    {
      "hadith" : " الحديث " ,
      "rawi" : " الراوي " ,
      "mohdith" : " المحدث " ,
      "mohdithId" : " رقم المحدث " ,
      "book" : " الكتاب " ,
      "bookId" : " رقم الكتاب " ,
      "numberOrPage" : " رقم الحديث او الصفحة " ,
      "grade" : " درجة الصحة " ,
      "explainGrade" : " توضيح درجة الصحة " ,
      "hadithId" : " رقم الحديث لاستخدامه في البحث عن الأحاديث البديلة أو الحديث البديل الصحيح " ,
      "hasSimilarHadith" : " هل الحديث له أحاديث مشابهة أم لا " ,
      "hasAlternateHadithSahih" : " هل الحديث له حديث صحيح بديل أم لا " ,
      "similarHadithDorar" : " رابط الأحاديث المشابهة في موقع الدرر " ,
      "alternateHadithSahihDorar" : " رابط الحديث الصحيح في موقع الدرر " ,
      "urlToGetSimilarHadith" : " رابط لكي تبحث عن الأحاديث المشابهة " ,
      "urlToGetAlternateHadithSahih" : " رابط لكي تبحث عن الحديث الصحيح " ,
      "hasSharhMetadata" : " هل الحديث له شرح أم لا " ,
      "sharhMetadata" : {
        "id" : " رقم الشرح " ,
        "isContainSharh" : " هل يحتوى هذا الرد على شرح الحديث أم لا؟ " ,
        "urlToGetSharh" : " رابط لكي تبحث عن شرح الحديث "
      }
    }
  ]
}

/v1/site/聖訓/:id

它為您帶來與id對應的對話

將響應格式化為JSON

{
  "metadata" : {
    "isCached" : " هل هذه النتائج من الـ cache أم لا "
  },
  "data" : {
    "hadith" : " الحديث " ,
    "rawi" : " الراوي " ,
    "mohdith" : " المحدث " ,
    "mohdithId" : " رقم المحدث " ,
    "book" : " الكتاب " ,
    "bookId" : " رقم الكتاب " ,
    "numberOrPage" : " رقم الحديث او الصفحة " ,
    "grade" : " درجة الصحة " ,
    "explainGrade" : " توضيح درجة الصحة " ,
    "hadithId" : " رقم الحديث لاستخدامه في البحث عن الأحاديث البديلة أو الحديث البديل الصحيح " ,
    "hasSimilarHadith" : " هل الحديث له أحاديث مشابهة أم لا " ,
    "hasAlternateHadithSahih" : " هل الحديث له حديث صحيح بديل أم لا " ,
    "similarHadithDorar" : " رابط الأحاديث المشابهة في موقع الدرر " ,
    "alternateHadithSahihDorar" : " رابط الحديث الصحيح في موقع الدرر " ,
    "urlToGetSimilarHadith" : " رابط لكي تبحث عن الأحاديث المشابهة " ,
    "urlToGetAlternateHadithSahih" : " رابط لكي تبحث عن الحديث الصحيح " ,
    "hasSharhMetadata" : " هل الحديث له شرح أم لا " ,
    "sharhMetadata" : {
      "id" : " رقم الشرح " ,
      "isContainSharh" : " هل يحتوى هذا الرد على شرح الحديث أم لا؟ " ,
      "urlToGetSharh" : " رابط لكي تبحث عن شرح الحديث "
    }
  }
}

/v1/site/hadith/alternate/:id

它為您帶來與id對應的正確聖訓

將響應格式化為JSON

{
  "metadata" : {
    "isCached" : " هل هذه النتائج من الـ cache أم لا "
  },
  "data" : {
    "hadith" : " الحديث " ,
    "rawi" : " الراوي " ,
    "mohdith" : " المحدث " ,
    "mohdithId" : " رقم المحدث " ,
    "book" : " الكتاب " ,
    "bookId" : " رقم الكتاب " ,
    "numberOrPage" : " رقم الحديث او الصفحة " ,
    "grade" : " درجة الصحة " ,
    "hadithId" : " رقم الحديث لاستخدامه في البحث عن الأحاديث البديلة أو الحديث البديل الصحيح " ,
    "hasSimilarHadith" : " هل الحديث له أحاديث مشابهة أم لا " ,
    "hasAlternateHadithSahih" : " هل الحديث له حديث صحيح بديل أم لا " ,
    "similarHadithDorar" : " رابط الأحاديث المشابهة في موقع الدرر " ,
    "urlToGetSimilarHadith" : " رابط لكي تبحث عن الأحاديث المشابهة " ,
    "hasSharhMetadata" : " هل الحديث له شرح أم لا " ,
    "sharhMetadata" : {
      "id" : " رقم الشرح " ,
      "isContainSharh" : " هل يحتوى هذا الرد على شرح الحديث أم لا؟ " ,
      "urlToGetSharh" : " رابط لكي تبحث عن شرح الحديث "
    }
  }
}

/v1/site/share/:id

使用id搜尋單一聖訓的解釋

將響應格式化為JSON

{
  "metadata" : {
    "isCached" : " هل هذه النتائج من الـ cache أم لا "
  },
  "data" : {
    "hadith" : " الحديث " ,
    "rawi" : " الراوي " ,
    "mohdith" : " المحدث " ,
    "book" : " الكتاب " ,
    "numberOrPage" : " رقم الحديث او الصفحة " ,
    "grade" : " درجة الصحة " ,
    "takhrij" : " تخريج الحديث في كتب أخرى " ,
    "hasSharhMetadata" : " هل الحديث له شرح أم لا " ,
    "sharhMetadata" : {
      "id" : " رقم الشرح " ,
      "isContainSharh" : " هل يحتوى هذا الرد على شرح الحديث أم لا؟ " ,
      "urlToGetSharh" : " رابط لكي تبحث عن شرح الحديث " ,
      "sharh" : " شرح الحديث "
    }
  }
}

/v1/site/share/text/:text

根據給定文本的方法搜尋某一聖訓的解釋

將響應格式化為JSON

{
  "metadata" : {
    "specialist" : " نوع الاحاديث هل هي للمتخصصين أم لا " ,
    "isCached" : " هل هذه النتائج من الـ cache أم لا "
  },
  "data" : {
    "hadith" : " الحديث " ,
    "rawi" : " الراوي " ,
    "mohdith" : " المحدث " ,
    "book" : " الكتاب " ,
    "numberOrPage" : " رقم الحديث او الصفحة " ,
    "grade" : " درجة الصحة " ,
    "takhrij" : " تخريج الحديث في كتب أخرى " ,
    "hasSharhMetadata" : " هل الحديث له شرح أم لا " ,
    "sharhMetadata" : {
      "id" : " رقم الشرح " ,
      "isContainSharh" : " هل يحتوى هذا الرد على شرح الحديث أم لا؟ " ,
      "urlToGetSharh" : " رابط لكي تبحث عن شرح الحديث " ,
      "sharh" : " شرح الحديث "
    }
  }
}

/v1/site/share/search?value={text}

搜尋聖訓的解釋給予30結果

將響應格式化為JSON

{
  "metadata" : {
    "length" : " عدد نتائج البحث " ,
    "page" : " رقم الصفحة " ,
    "removeHTML" : " هل عناصر الـ HTML ممسوحة أم لا " ,
    "specialist" : " نوع الاحاديث هل هي للمتخصصين أم لا " ,
    "isCached" : " هل هذه النتائج من الـ cache أم لا "
  },
  "data" : [
    {
      "hadith" : " الحديث " ,
      "rawi" : " الراوي " ,
      "mohdith" : " المحدث " ,
      "book" : " الكتاب " ,
      "numberOrPage" : " رقم الحديث او الصفحة " ,
      "grade" : " درجة الصحة " ,
      "takhrij" : " تخريج الحديث في كتب أخرى " ,
      "hasSharhMetadata" : " هل الحديث له شرح أم لا " ,
      "sharhMetadata" : {
        "id" : " رقم الشرح " ,
        "isContainSharh" : " هل يحتوى هذا الرد على شرح الحديث أم لا؟ " ,
        "urlToGetSharh" : " رابط لكي تبحث عن شرح الحديث " ,
        "sharh" : " شرح الحديث "
      }
    }
  ]
}

/v1/site/mohdith/:id

使用id搜尋有關說話者的信息

將響應格式化為JSON

{
  "metadata" : {
    "isCached" : " هل هذه النتائج من الـ cache أم لا "
  },
  "data" : {
    "name" : " المحدث " ,
    "mohdithId" : " رقم المحدث " ,
    "info" : " معلومات عن المحدث "
  }
}

/v1/site/book/:id

使用id搜尋有關圖書的信息

將響應格式化為JSON

{
  "metadata" : {
    "isCached" : " هل هذه النتائج من الـ cache أم لا "
  },
  "data" : {
    "name" : " الكتاب " ,
    "bookId" : " رقم الكتاب " ,
    "author" : " المؤلف " ,
    "reviewer" : " المراجع " ,
    "publisher" : " دار النشر " ,
    "edition" : " رقم الطبعة " ,
    "editionYear" : " سنة الطبعة "
  }
}

詢問

您可以使用的query元素
表格下方有詳細說明

關鍵。	描述
`value`	就是你要找的聖訓正文的內容
`page`	選擇您想要的頁面
`removehtml`	刪除語音中的`HTML`元素
`specialist`	它用於確定聖訓的類型，無論它們是否適合專家
`xclude`	您想要從搜尋中排除的單字或短語
`st`	確定搜尋方法
`t`	定義搜尋範圍
`d[]`	確定聖訓的程度，是正宗還是薄弱
`m[]`	指定您想要的更新的名稱
`s[]`	選擇您要搜尋的書籍
`rawi[]`	指定您想要的敘述者的姓名

這些方括號[]表示該元素接受多個選項

值。

您要搜尋的聖訓文本的內容
範例： /v1/api/hadith/search?value=جملة البحث
這將根據搜尋字詞進行搜索

頁

選擇您想要的頁面
範例： /v1/api/hadith/search?value=جملة البحث&page=1
這將搜尋第三頁的搜尋結果，即第三組搜尋結果
預設值為一頁page=1

刪除html

刪除語音中的HTML元素
如<span class="search-keys">...</span>
範例： /v1/api/hadith/search?value=جملة البحث&removehtml=true
這將從搜尋結果中刪除HTML元素
預設值為true

專家

它用於確定聖訓的類型，無論它們是否適合專家
它的值對於專家來說是true ，對於非專家來說是false
範例： /v1/api/hadith/search?value=جملة البحث&specialist=true
它將為您提供更多、不同的對話，尤其是對於專家而言
它包含附加信息，例如其他書籍中的聖訓分級
預設值為false

排除

範例：您想要從搜尋中排除的單字或短語
範例： /v1/api/hadith/search?value=جملة البحث&xclude=اليهود
因此， اليهود一詞將被排除在搜索之外

英石

搜尋方法僅限於三種選項
這些方法是： جميع الكلمات 、 أي كلمة 、 بحث مطابق
其值為： w 、 a 、 p
要按جميع الكلمات st=w
要搜尋أي كلمة它將是st=a
要使用بحث مطابق st=p
範例： /v1/api/hadith/search?value=جملة البحث&st=p
因此，它將與搜尋字詞進行相同的搜索

他們所代表的一切價值觀和研究方法
或者您可以從這裡取得JSON文件

t

定義搜尋範圍
這些範圍是： جميع الأحاديث 、 الأحاديث المرفوعة 、 الأحاديث القدسية 、 آثار الصحابة 、 شروح الأحاديث
其值為： * , 0 , 1 , 2 , 3
要搜尋جميع الأحاديث它將是t=*
要搜尋الأحاديث المرفوعة ， t=0
為了尋找الأحاديث القدسية t=1
尋找آثار الصحابة t=2
要搜尋شروح الأحاديث ， t=3
範例： /v1/api/hadith/search?value=جملة البحث&t=1
因此，它將僅搜尋與搜尋字詞相符的聖訓

所有值及其代表的搜尋範圍
或者您可以從這裡取得JSON文件

d[]

確定聖訓的程度，是正宗還是薄弱
3 4 2 0
要搜尋جميع الدرجات d[]=0
要搜尋أحاديث حكم المحدثون عليها بالصحة則d[]=1
要搜尋أحاديث حكم المحدثون على أسانيدها بالصحة則d[]=2
要搜尋أحاديث حكم المحدثون عليها بالضعف則d[]=3
要搜尋أحاديث حكم المحدثون على أسانيدها بالضعف則d[]=4
範例： /v1/api/hadith/search?value=جملة البحث&d[]=3
因此，他只會尋找那些注定是軟弱的聖訓
您可以選擇多個選項
範例： /v1/api/hadith/search?value=جملة البحث&d[]=1&d[]=2
因此，他只會尋找在文本和傳播鏈上被判斷為真實的聖訓

它們所代表的所有數值和度數
或者您可以從這裡取得JSON文件

米[]

指定您想要的更新的名稱
它有多個值，包括： 0 、 179 、 204 、 256 、 261 ...等。
其中0代表جميع المحدثين
179代表الإمام المالك
204代表الإمام الشافعي
256代表البخاري
而261代表مسلم
範例： /v1/api/hadith/search?value=جملة البحث&m[]=179
因此，他只會搜尋伊瑪目馬利克所述的聖訓
您可以選擇多個選項
範例： /v1/api/hadith/search?value=جملة البحث&m[]=256&m[]=261
因此，他只會尋找布哈里和穆斯林所傳述的聖訓。

所有的價值觀和他們所代表的發言者的名字
或者您可以從這裡取得JSON文件

s[]

選擇您要搜尋的書籍
它有多個值，包括： 0 、 13457 、 6216 、 3088 、 96 ...等。
其中0代表جميع المحدثين ， 13457代表الأربعون النووية
6216代表صحيح البخاري
而3088代表صحيح مسلم
96代表الصحيح المسند
範例： /v1/api/hadith/search?value=جملة البحث&s[]=96
因此，他將只搜尋《Al-Sahih Al-Musnad》一書中包含的聖訓
您可以選擇多個選項
範例： /v1/api/hadith/search?value=جملة البحث&s[]=6216&s[]=13457
因此，他將只搜尋我的書《四十納瓦維》和《布哈里聖訓實錄》中提到的聖訓

所有的數值以及它們所代表的書名
或者您可以從這裡取得JSON文件

拉維[]

指定您想要的敘述者的姓名
它有多個值，包括： 0 、 1819 、 8918 、 2664 ...等。
其中0代表جميع الرواة
其中1819代表أسماء بنت أبي بكر
8918代表عمر بن الخطاب
2664代表ابن عباس
範例： /v1/api/hadith/search?value=جملة البحث&rawi[]=1819
因此，他只會搜尋阿斯瑪·本特·阿比·伯克爾所述的聖訓
您可以選擇多個選項
範例： /v1/api/hadith/search?value=جملة البحث&rawi[]=8918&rawi[]=2664
因此，他將只搜尋奧馬爾·本·哈塔布和伊本·阿巴斯敘述的聖訓
以下是同時象徵多個人的價值觀
例如2665象徵ابن عباس أو أبو هريرة
8924象徵عمر بن الخطاب وأبو هريرة
264象徵أبو الدرداء وأبو أمامة وعبدالله بن عمر وابن عباس وجابر بن عبدالله

所有的價值觀以及代表它們的敘述者的名字
或者您可以從這裡取得JSON文件

數據

所有可用數據及其代表的值都可以從這些endpoints獲得

[
  {
    "endpoint" : " /v1/data/book " ,
    "description" : " احضار كل الكتب المتاحة " ,
    "abstractResponse" : [
      {
        "key" : " الكلمة  المفتاحية " ,
        "value" : " القيمة "
      }
    ]
  },
  {
    "endpoint" : " /v1/data/degree " ,
    "description" : " احضار كل درجات الحديث المتاحة " ,
    "abstractResponse" : [
      {
        "key" : " الكلمة  المفتاحية " ,
        "value" : " القيمة "
      }
    ]
  },
  {
    "endpoint" : " /v1/data/methodSearch " ,
    "description" : " احضار كل طرق البحث المتاحة " ,
    "abstractResponse" : [
      {
        "key" : " الكلمة  المفتاحية " ,
        "value" : " القيمة "
      }
    ]
  },
  {
    "endpoint" : " /v1/data/mohdith " ,
    "description" : " احضار كل المحدثين المتاحين " ,
    "abstractResponse" : [
      {
        "key" : " الكلمة  المفتاحية " ,
        "value" : " القيمة "
      }
    ]
  },
  {
    "endpoint" : " /v1/data/rawi " ,
    "description" : " احضار كل الرواة المتاحين " ,
    "abstractResponse" : [
      {
        "key" : " الكلمة  المفتاحية " ,
        "value" : " القيمة "
      }
    ]
  },
  {
    "endpoint" : " /v1/data/zoneSearch " ,
    "description" : " احضار كل نطاقات البحث المتاحة " ,
    "abstractResponse" : [
      {
        "key" : " الكلمة  المفتاحية " ,
        "value" : " القيمة "
      }
    ]
  }
]

有問題或有建議嗎？

如果您遇到問題或有建議，請開啟問題

貢獻

當然，我們歡迎任何貢獻❤

展開