dorar hadith apiダウンロード - dorar hadith apiソースコードのダウンロード

Dorar.net ハディース API

神の平安、祝福、慈悲があなたの上にありますように

少し前に、デンタルパールAPI使用してみました
しかし、 API JSONP のみを処理し、CORS のせいで通常の方法では処理できないなど、いくつかの困難に直面しました。

JSONP を使用してCORS回避することに成功するとJSONP HTML形式で出力が得られます。また、このAPIの詳細とその対処方法を説明するdocumentationやドキュメントはありません。

CORS問題を回避し、 APIとその使用方法の詳細な説明とともにJSON形式でデータを提供する中間APIを作成することにしました。
公式APIにはないいくつかの追加機能が含まれていることに加えて、

警告

各検索は5秒間cacheれます
使用制限があります: IPごとに 1 日あたり100検索

config.js ファイルから編集できます。

APIを実行する

このプロジェクトをforkまたはclone
dependenciesをインストールする

npm install

config.js ファイルを確認し、必要に応じて変更します。
API実行する

npm start

API次のリンクから入手できます。

http://localhost:5000

必要に応じてlocalhostで使用するか、独自のホスティングまたはサーバーにアップロードします

ドキュメント

郵便屋さん

リンク: 郵便配達員

Postmanを使用してAPIの操作方法を学び、例を参照してください。
collection fork必要に応じて使用します
environment dev変数{{url}}のリンクを変更できますport

OpenAPI v3 (Swagger)

APIドキュメント

インタラクティブな API ドキュメントを表示するには:

サーバーを実行します。
```
 npm run dev
```
ブラウザを開いて、次の場所に移動します。
```
 http://localhost:5000/api-docs
```

ここには、利用可能なすべてのエンドポイントを探索し、ブラウザから直接 API をテストできる Swagger UI があります。

エンドポイント

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={テキスト}

ハディースを検索すると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/サイト/ハディース/類似/: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/サイト/ハディス/: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/サイト/共有/: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

指定されたテキストの方法に基づいて 1 つのハディースの説明を検索する

応答をJSONとしてフォーマットする

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

/v1/site/share/search?value={テキスト}

ハディースの説明を検索すると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/サイト/ブック/: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
これにより、3 ページ目の検索結果、つまり 3 番目の検索結果グループが検索されます。
デフォルト値はページ 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=اليهود
したがって、 اليهود単語は検索から除外されます。

セント

検索方法は 3 つのみに限定されます
これらの方法は次のとおりです: جميع الكلمات 、 أي كلمة 、 بحث مطابق
その値は次のとおりです: 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[]

ハディースの程度を判断する（本物か弱いか）
その値は次のとおりです: 0 、 1 、 2 、 3 、 4
جميع الدرجاتを検索するには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ファイルとして取得できます

m[]

必要なアップデートの名前を指定します
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
したがって、彼はアル・サーヒ・アル・ムスナドという本に含まれるハディースのみを検索します。
複数のオプションを選択できます
例: /v1/api/hadith/search?value=جملة البحث&s[]=6216&s[]=13457
したがって、彼は私の本『The Forty Nawawi』と『Sahih Al-Bukhari』の本で言及されたハディースのみを検索するでしょう。

すべての値とそれが表す本の名前
または、ここから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" : " القيمة "
      }
    ]
  }
]

問題がありますか、それとも提案はありますか?

問題が発生した場合や提案がある場合は、問題をオープンしてください

貢献

もちろん、私たちの貢献は大歓迎です❤

拡大する