dorar hadith api Télécharger - dorar hadith api Téléchargement du code source

API Hadith de Dorar.net

Que la paix, les bénédictions et la miséricorde de Dieu soient sur vous

Il y a quelque temps, j'ai essayé d'utiliser l' API des perles dentaires
Mais j'ai rencontré quelques difficultés, notamment le fait que l' API ne traite que JSONP et que vous ne pourrez pas le gérer de manière normale à cause de CORS.

Si vous réussissez à éviter CORS en utilisant JSONP vous obtiendrez le résultat au format HTML . De plus, il n'existe aucune documentation ou document expliquant les détails de cette API et comment la gérer.

J'ai décidé de créer une API intermédiaire qui évite le problème CORS et vous donne les données au format JSON ainsi qu'une explication détaillée de l' API et comment l'utiliser.
En plus de contenir quelques fonctionnalités supplémentaires que l'on ne retrouve pas dans l' API officielle

alerte

Chaque recherche est cache pendant 5 secondes
Il y a une limite d'utilisation : 100 recherches par jour et par IP

Vous pouvez les modifier depuis le fichier config.js

Exécutez l'API

fork ou clone ce projet
Installer dependencies

npm install

Vérifiez le fichier config.js et modifiez ce que vous voulez
Exécutez l' API

npm start

L' API sera disponible sur le lien suivant

http://localhost:5000

Utilisez-le sur localhost comme vous le souhaitez, ou téléchargez-le sur votre propre hébergement ou serveur

Documentation

Facteur

Lien : Facteur

Utilisez Postman pour apprendre à utiliser l' API et voir des exemples
fork la collection pour l'utiliser comme vous le souhaitez
N'oubliez pas de changer l' environment en dev et vous pouvez changer le lien vers la variable {{url}} si vous l'avez modifié ou changé le port

OpenAPI v3 (Swagger)

Documentation API

Pour afficher la documentation interactive de l'API :

Exécutez le serveur :
```
 npm run dev
```
Ouvrez votre navigateur et accédez à :
```
 http://localhost:5000/api-docs
```

Vous trouverez ici l'interface utilisateur Swagger qui vous permet d'explorer tous les points de terminaison disponibles et de tester l'API directement depuis le navigateur.

Points de terminaison

L' API contient un ensemble de endpoint

Lorsque le endpoint commence par /api , il effectue une recherche via l' API officielle Durar Al-Suniya.
Lorsque le endpoint commence par /site , voici comment il est recherché via la page de recherche Durar Al-Sunniyya

/v1/api/hadith/search?value={texte}

La recherche de hadiths donne 15 résultats

Formatez la réponse en JSON

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

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

La recherche de hadiths donne 30 résultats

Formatez la réponse en 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/similaire/:id

Il vous apporte des conversations similaires correspondant à l' id

Formatez la réponse en 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/hadith/:id

Il vous apporte le hadith correspondant à l' id

Formatez la réponse en 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/alternatif/:id

Il vous apporte le bon hadith correspondant à l' id

Formatez la réponse en 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

Pour rechercher une explication d'un seul hadith à l'aide id

Formatez la réponse en JSON

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

/v1/site/share/text/:texte

Rechercher une explication d’un hadith en se basant sur la méthode du texte donné

Formatez la réponse en 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}

La recherche d'une explication des hadiths donne 30 résultats

Formatez la réponse en 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

Pour rechercher des informations sur l’orateur à l’aide de l’ id

Formatez la réponse en JSON

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

/v1/site/livre/:id

Pour rechercher des informations sur le livre à l'aide de l' id

Formatez la réponse en JSON

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

Requête

Éléments query que vous pouvez utiliser
Avec une explication détaillée sous le tableau

clé.	Description
`value`	C'est le contenu du texte du hadith que vous souhaitez rechercher
`page`	Pour sélectionner la page souhaitée
`removehtml`	Supprimer les éléments `HTML` dans le discours
`specialist`	Il permet de déterminer le type de hadiths, s'ils sont destinés à des spécialistes ou non.
`xclude`	Un mot ou une expression que vous souhaitez exclure de la recherche
`st`	Déterminer la méthode de recherche
`t`	Définir la portée de la recherche
`d[]`	Déterminer le degré du hadith, s'il est authentique ou faible
`m[]`	Spécifiez les noms des mises à jour souhaitées
`s[]`	Sélectionnez les livres que vous souhaitez rechercher
`rawi[]`	Précisez les noms des narrateurs souhaités

Ces crochets [] indiquent que cet élément accepte plus d'une option

valeur.

Contenu du texte du hadith que vous souhaitez rechercher
Exemple : /v1/api/hadith/search?value=جملة البحث
Cela effectuera une recherche en fonction du terme de recherche

supprimerhtml

Supprimer les éléments HTML dans le discours
Tels que <span class="search-keys">...</span>
Exemple : /v1/api/hadith/search?value=جملة البحث&removehtml=true
Cela supprimera les éléments HTML des résultats de recherche
La valeur par défaut est true

spécialiste

Il permet de déterminer le type de hadiths, s'ils sont destinés à des spécialistes ou non.
Ses valeurs sont true pour les spécialistes et false pour les non-spécialistes
Exemple : /v1/api/hadith/search?value=جملة البحث&specialist=true
Cela vous donnera des conversations plus nombreuses et différentes, notamment pour les spécialistes
Il contient des informations supplémentaires, telles que la notation des hadiths dans d'autres livres.
La valeur par défaut est false

exclure

Exemple : un mot ou une expression que vous souhaitez exclure de la recherche
Exemple : /v1/api/hadith/search?value=جملة البحث&xclude=اليهود
Ainsi, le mot اليهود sera exclu de la recherche

St

La méthode de recherche est limitée à seulement trois options
Ces méthodes sont : جميع الكلمات , أي كلمة , بحث مطابق
Ses valeurs sont : w , a , p
Pour rechercher par جميع الكلمات st=w
Pour rechercher أي كلمة ce sera st=a
Pour effectuer بحث مطابق st=p
Exemple : /v1/api/hadith/search?value=جملة البحث&st=p
Ainsi, il recherchera de manière identique au terme de recherche

Toutes les valeurs et méthodes de recherche qu’ils représentent
Ou vous pouvez l'obtenir sous forme de fichier JSON à partir d'ici

t

Définir la portée de la recherche
Ces gammes sont : جميع الأحاديث , الأحاديث المرفوعة , الأحاديث القدسية , آثار الصحابة , شروح الأحاديث
Ses valeurs sont : * , 0 , 1 , 2 , 3
Pour rechercher جميع الأحاديث ce sera t=*
Pour rechercher الأحاديث المرفوعة , t=0
Pour rechercher الأحاديث القدسية t=1
Pour rechercher آثار الصحابة t=2
Pour rechercher شروح الأحاديث , t=3
Exemple : /v1/api/hadith/search?value=جملة البحث&t=1
Ainsi, il recherchera uniquement les hadiths sacrés correspondant au terme de recherche.

Toutes les valeurs et les plages de recherche qu'elles représentent
Ou vous pouvez l'obtenir sous forme de fichier JSON à partir d'ici

d[]

Déterminer le degré du hadith, s'il est authentique ou faible
Ses valeurs sont : 0 , 1 , 2 , 3 , 4
Pour rechercher جميع الدرجات d[]=0
Pour rechercher des أحاديث حكم المحدثون عليها بالصحة ce sera d[]=1
Pour rechercher des أحاديث حكم المحدثون على أسانيدها بالصحة ce sera d[]=2
Pour rechercher des أحاديث حكم المحدثون عليها بالضعف ce sera d[]=3
Pour rechercher des أحاديث حكم المحدثون على أسانيدها بالضعف ce sera d[]=4
Exemple : /v1/api/hadith/search?value=جملة البحث&d[]=3
Ainsi, il ne recherchera que les hadiths voués à être faibles.
Vous pouvez sélectionner plusieurs options
Exemple : /v1/api/hadith/search?value=جملة البحث&d[]=1&d[]=2
Ainsi, il ne recherchera que les hadiths jugés authentiques en termes de texte et de chaîne de transmission.

Toutes les valeurs et degrés qu'ils représentent
Ou vous pouvez l'obtenir sous forme de fichier JSON à partir d'ici

m[]

Spécifiez les noms des mises à jour souhaitées
Il a plusieurs valeurs, notamment : 0 , 179 , 204 , 256 , 261 ...etc.
Où 0 représente جميع المحدثين
Et 179 représente الإمام المالك
Et 204 représente الإمام الشافعي
Et 256 représente البخاري
Et 261 représente مسلم
Exemple : /v1/api/hadith/search?value=جملة البحث&m[]=179
Ainsi, il recherchera uniquement les hadiths rapportés par l'Imam Malik.
Vous pouvez sélectionner plusieurs options
Exemple : /v1/api/hadith/search?value=جملة البحث&m[]=256&m[]=261
Ainsi, il recherchera uniquement les hadiths rapportés par Bukhari et Muslim.

Toutes les valeurs et les noms des intervenants qu'ils représentent
Ou vous pouvez l'obtenir sous forme de fichier JSON à partir d'ici

s[]

Sélectionnez les livres que vous souhaitez rechercher
Il a plusieurs valeurs, notamment : 0 , 13457 , 6216 , 3088 , 96 ...etc.
Où 0 représente جميع المحدثين et 13457 représente الأربعون النووية
Et 6216 représente صحيح البخاري
Et 3088 représente صحيح مسلم
Et 96 représente الصحيح المسند
Exemple : /v1/api/hadith/search?value=جملة البحث&s[]=96
Ainsi, il recherchera uniquement les hadiths contenus dans le livre Al-Sahih Al-Musnad
Vous pouvez sélectionner plusieurs options
Exemple : /v1/api/hadith/search?value=جملة البحث&s[]=6216&s[]=13457
Ainsi, il recherchera uniquement les hadiths mentionnés dans mon livre Les Quarante Nawawi et le livre Sahih Al-Bukhari.

Toutes les valeurs et les noms des livres qu'elles représentent
Ou vous pouvez l'obtenir sous forme de fichier JSON à partir d'ici

Rawi[]

Précisez les noms des narrateurs souhaités
Il a plusieurs valeurs, notamment : 0 , 1819 , 8918 , 2664 ...etc.
Où 0 représente جميع الرواة
Où 1819 représente أسماء بنت أبي بكر
Et 8918 représente عمر بن الخطاب
Et 2664 représente ابن عباس
Exemple : /v1/api/hadith/search?value=جملة البحث&rawi[]=1819
Ainsi, il recherchera uniquement les hadiths rapportés par Asmaa bint Abi Bakr
Vous pouvez sélectionner plusieurs options
Exemple : /v1/api/hadith/search?value=جملة البحث&rawi[]=8918&rawi[]=2664
Ainsi, il recherchera uniquement les hadiths rapportés par Omar bin Al-Khattab et Ibn Abbas
Voici des valeurs qui symbolisent plus d'une personne à la fois
Tel que 2665 symbolise ابن عباس أو أبو هريرة
Et 8924 symbolise عمر بن الخطاب وأبو هريرة
Et 264 symbolise أبو الدرداء وأبو أمامة وعبدالله بن عمر وابن عباس وجابر بن عبدالله

Toutes les valeurs et les noms des narrateurs qui les représentent
Ou vous pouvez l'obtenir sous forme de fichier JSON à partir d'ici

Données

Toutes les données disponibles et les valeurs qu'elles représentent peuvent être obtenues à partir de ces 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" : " القيمة "
      }
    ]
  }
]

Il y a un problème ou avez-vous une suggestion ?

Ouvrez un ticket si vous rencontrez un problème ou avez une suggestion

Contribution

Bien sûr, nous apprécions chacune de nos contributions ❤

Développer