Mögen der Friede, der Segen und die Barmherzigkeit Gottes mit Ihnen sein
Vor einiger Zeit habe ich versucht, die Dental Pearls API
zu verwenden
Aber ich hatte einige Schwierigkeiten, unter anderem, dass die API
nur JSONP verarbeitet und man wegen CORS nicht auf normale Weise damit umgehen kann.
Wenn es Ihnen gelingt, CORS
durch die Verwendung JSONP
erhalten Sie die Ausgabe im HTML
Format. Außerdem gibt es keine documentation
oder ein Dokument, das die Details dieser API
und den Umgang damit erklärt.
Ich habe beschlossen, eine Zwischen API
zu erstellen, die das CORS
-Problem vermeidet und Ihnen die Daten im JSON
-Format zusammen mit einer detaillierten Erklärung der API
und ihrer Verwendung bereitstellt
Darüber hinaus enthält es einige zusätzliche Funktionen, die in der offiziellen API
nicht enthalten sind
5
Sekunden lang cache
100
Suchanfragen pro Tag und IP
Sie können sie über die Datei config.js bearbeiten
fork
oder clone
dieses Projektdependencies
installieren npm install
API
aus npm start
API
ist unter folgendem Link verfügbar http://localhost:5000
localhost
oder laden Sie es auf Ihr eigenes Hosting oder Ihren eigenen Server hoch Link: Postbote
Postman
um zu lernen, wie man mit der API
arbeitet, und sehen Sie sich Beispiele anfork
die collection
auf, um sie nach Ihren Wünschen zu verwendenenvironment
auf dev
und Sie können den Link für die Variable {{url}}
ändern, wenn Sie ihn oder den port
So zeigen Sie die interaktive API-Dokumentation an:
Führen Sie den Server aus:
npm run dev
Öffnen Sie Ihren Browser und gehen Sie zu:
http://localhost:5000/api-docs
Hier finden Sie die Swagger-Benutzeroberfläche, mit der Sie alle verfügbaren Endpunkte erkunden und die API direkt über den Browser testen können.
Die API
enthält eine Reihe von endpoint
endpoint
mit /api
beginnt, durchsucht er die offizielle Durar Al-Suniya API
endpoint
mit /site
beginnt, wird er auf folgende Weise auf der Durar Al-Sunniyya-Suchseite durchsucht Die Suche nach Hadithen liefert 15
Ergebnisse
Formatieren Sie die Antwort als JSON
{
"metadata" : {
"length" : " عدد نتائج البحث " ,
"page" : " رقم الصفحة " ,
"removeHTML" : " هل عناصر الـ HTML ممسوحة أم لا " ,
"isCached" : " هل هذه النتائج من الـ cache أم لا "
},
"data" : [
{
"hadith" : " الحديث " ,
"rawi" : " الراوي " ,
"mohdith" : " المحدث " ,
"book" : " الكتاب " ,
"numberOrPage" : " رقم الحديث او الصفحة " ,
"grade" : " درجة الصحة "
}
]
}
Die Suche nach Hadithen liefert 30
Ergebnisse
Formatieren Sie die Antwort als 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" : " رابط لكي تبحث عن شرح الحديث "
}
}
]
}
Es bringt Ihnen ähnliche Gespräche, die der id
entsprechen
Formatieren Sie die Antwort als 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" : " رابط لكي تبحث عن شرح الحديث "
}
}
]
}
Es bringt Ihnen die Konversation, die der id
entspricht
Formatieren Sie die Antwort als 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" : " رابط لكي تبحث عن شرح الحديث "
}
}
}
Es bringt Ihnen den richtigen Hadith, der der id
entspricht
Formatieren Sie die Antwort als JSON
{
"metadata" : {
"isCached" : " هل هذه النتائج من الـ cache أم لا "
},
"data" : {
"hadith" : " الحديث " ,
"rawi" : " الراوي " ,
"mohdith" : " المحدث " ,
"mohdithId" : " رقم المحدث " ,
"book" : " الكتاب " ,
"bookId" : " رقم الكتاب " ,
"numberOrPage" : " رقم الحديث او الصفحة " ,
"grade" : " درجة الصحة " ,
"hadithId" : " رقم الحديث لاستخدامه في البحث عن الأحاديث البديلة أو الحديث البديل الصحيح " ,
"hasSimilarHadith" : " هل الحديث له أحاديث مشابهة أم لا " ,
"hasAlternateHadithSahih" : " هل الحديث له حديث صحيح بديل أم لا " ,
"similarHadithDorar" : " رابط الأحاديث المشابهة في موقع الدرر " ,
"urlToGetSimilarHadith" : " رابط لكي تبحث عن الأحاديث المشابهة " ,
"hasSharhMetadata" : " هل الحديث له شرح أم لا " ,
"sharhMetadata" : {
"id" : " رقم الشرح " ,
"isContainSharh" : " هل يحتوى هذا الرد على شرح الحديث أم لا؟ " ,
"urlToGetSharh" : " رابط لكي تبحث عن شرح الحديث "
}
}
}
Um nach einer Erklärung für einen einzelnen Hadith zu suchen, verwenden Sie id
Formatieren Sie die Antwort als JSON
{
"metadata" : {
"isCached" : " هل هذه النتائج من الـ cache أم لا "
},
"data" : {
"hadith" : " الحديث " ,
"rawi" : " الراوي " ,
"mohdith" : " المحدث " ,
"book" : " الكتاب " ,
"numberOrPage" : " رقم الحديث او الصفحة " ,
"grade" : " درجة الصحة " ,
"takhrij" : " تخريج الحديث في كتب أخرى " ,
"hasSharhMetadata" : " هل الحديث له شرح أم لا " ,
"sharhMetadata" : {
"id" : " رقم الشرح " ,
"isContainSharh" : " هل يحتوى هذا الرد على شرح الحديث أم لا؟ " ,
"urlToGetSharh" : " رابط لكي تبحث عن شرح الحديث " ,
"sharh" : " شرح الحديث "
}
}
}
Suche nach einer Erklärung eines Hadith basierend auf der Methode des gegebenen Textes
Formatieren Sie die Antwort als JSON
{
"metadata" : {
"specialist" : " نوع الاحاديث هل هي للمتخصصين أم لا " ,
"isCached" : " هل هذه النتائج من الـ cache أم لا "
},
"data" : {
"hadith" : " الحديث " ,
"rawi" : " الراوي " ,
"mohdith" : " المحدث " ,
"book" : " الكتاب " ,
"numberOrPage" : " رقم الحديث او الصفحة " ,
"grade" : " درجة الصحة " ,
"takhrij" : " تخريج الحديث في كتب أخرى " ,
"hasSharhMetadata" : " هل الحديث له شرح أم لا " ,
"sharhMetadata" : {
"id" : " رقم الشرح " ,
"isContainSharh" : " هل يحتوى هذا الرد على شرح الحديث أم لا؟ " ,
"urlToGetSharh" : " رابط لكي تبحث عن شرح الحديث " ,
"sharh" : " شرح الحديث "
}
}
}
Die Suche nach einer Erklärung der Hadithe liefert 30
Ergebnisse
Formatieren Sie die Antwort als JSON
{
"metadata" : {
"length" : " عدد نتائج البحث " ,
"page" : " رقم الصفحة " ,
"removeHTML" : " هل عناصر الـ HTML ممسوحة أم لا " ,
"specialist" : " نوع الاحاديث هل هي للمتخصصين أم لا " ,
"isCached" : " هل هذه النتائج من الـ cache أم لا "
},
"data" : [
{
"hadith" : " الحديث " ,
"rawi" : " الراوي " ,
"mohdith" : " المحدث " ,
"book" : " الكتاب " ,
"numberOrPage" : " رقم الحديث او الصفحة " ,
"grade" : " درجة الصحة " ,
"takhrij" : " تخريج الحديث في كتب أخرى " ,
"hasSharhMetadata" : " هل الحديث له شرح أم لا " ,
"sharhMetadata" : {
"id" : " رقم الشرح " ,
"isContainSharh" : " هل يحتوى هذا الرد على شرح الحديث أم لا؟ " ,
"urlToGetSharh" : " رابط لكي تبحث عن شرح الحديث " ,
"sharh" : " شرح الحديث "
}
}
]
}
Um anhand der id
nach Informationen über den Sprecher zu suchen
Formatieren Sie die Antwort als JSON
{
"metadata" : {
"isCached" : " هل هذه النتائج من الـ cache أم لا "
},
"data" : {
"name" : " المحدث " ,
"mohdithId" : " رقم المحدث " ,
"info" : " معلومات عن المحدث "
}
}
Um anhand der id
nach Informationen über das Buch zu suchen
Formatieren Sie die Antwort als JSON
{
"metadata" : {
"isCached" : " هل هذه النتائج من الـ cache أم لا "
},
"data" : {
"name" : " الكتاب " ,
"bookId" : " رقم الكتاب " ,
"author" : " المؤلف " ,
"reviewer" : " المراجع " ,
"publisher" : " دار النشر " ,
"edition" : " رقم الطبعة " ,
"editionYear" : " سنة الطبعة "
}
}
query
, die Sie verwenden können
Mit ausführlicher Erläuterung unterhalb der Tabelle
Schlüssel | Beschreibung |
---|---|
value | Es ist der Inhalt des Textes des Hadith, nach dem Sie suchen möchten |
page | Zur Auswahl der gewünschten Seite |
removehtml | Löschen Sie HTML Elemente in der Sprache |
specialist | Es wird verwendet, um die Art der Hadithe zu bestimmen, ob sie für Spezialisten bestimmt sind oder nicht |
xclude | Ein Wort oder eine Phrase, die Sie von der Suche ausschließen möchten |
st | Bestimmen Sie die Suchmethode |
t | Definieren Sie den Suchbereich |
d[] | Bestimmen Sie den Grad des Hadith, ob er authentisch oder schwach ist |
m[] | Geben Sie die Namen der gewünschten Updates an |
s[] | Wählen Sie die Bücher aus, nach denen Sie suchen möchten |
rawi[] | Geben Sie die Namen der gewünschten Erzähler an |
[]
geben an, dass dieses Element mehr als eine Option akzeptiert /v1/api/hadith/search?value=جملة البحث
/v1/api/hadith/search?value=جملة البحث&page=1
page=1
HTML
Elemente in der Sprache<span class="search-keys">...</span>
/v1/api/hadith/search?value=جملة البحث&removehtml=true
HTML
Elemente aus den Suchergebnissen gelöschttrue
true
für Spezialisten und false
für Nicht-Spezialisten/v1/api/hadith/search?value=جملة البحث&specialist=true
false
/v1/api/hadith/search?value=جملة البحث&xclude=اليهود
اليهود
von der Suche ausgeschlossen جميع الكلمات
, أي كلمة
, بحث مطابق
w
, a
, p
جميع الكلمات
st=w
أي كلمة
ist es st=a
بحث مطابق
st=p
/v1/api/hadith/search?value=جملة البحث&st=p
Alle Werte und Forschungsmethoden, die sie vertreten
Oder Sie können es hier als JSON
Datei herunterladen
جميع الأحاديث
, الأحاديث المرفوعة
, الأحاديث القدسية
, آثار الصحابة
, شروح الأحاديث
*
, 0
, 1
, 2
, 3
جميع الأحاديث
wird t=*
verwendet.الأحاديث المرفوعة
zu suchen, t=0
الأحاديث القدسية
t=1
آثار الصحابة
zu suchen t=2
شروح الأحاديث
zu suchen, t=3
/v1/api/hadith/search?value=جملة البحث&t=1
Alle Werte und die Suchbereiche, die sie darstellen
Oder Sie können es hier als JSON
Datei herunterladen
0
, 1
, 2
, 3
, 4
جميع الدرجات
zu suchen d[]=0
أحاديث حكم المحدثون عليها بالصحة
wird d[]=1
verwendetأحاديث حكم المحدثون على أسانيدها بالصحة
wird d[]=2
verwendetأحاديث حكم المحدثون عليها بالضعف
wird d[]=3
verwendetأحاديث حكم المحدثون على أسانيدها بالضعف
wird d[]=4
verwendet/v1/api/hadith/search?value=جملة البحث&d[]=3
/v1/api/hadith/search?value=جملة البحث&d[]=1&d[]=2
Alle Werte und Grade, die sie darstellen
Oder Sie können es hier als JSON
Datei herunterladen
0
, 179
, 204
, 256
, 261
... usw.0
für جميع المحدثين
179
repräsentiert الإمام المالك
204
repräsentiert الإمام الشافعي
256
repräsentiert البخاري
261
steht für مسلم
/v1/api/hadith/search?value=جملة البحث&m[]=179
/v1/api/hadith/search?value=جملة البحث&m[]=256&m[]=261
Alle Werte und die Namen der Sprecher, die sie vertreten
Oder Sie können es hier als JSON
Datei herunterladen
0
, 13457
, 6216
, 3088
, 96
... usw.0
für جميع المحدثين
und 13457
für الأربعون النووية
6216
steht für صحيح البخاري
3088
steht für صحيح مسلم
96
stellt الصحيح المسند
dar/v1/api/hadith/search?value=جملة البحث&s[]=96
/v1/api/hadith/search?value=جملة البحث&s[]=6216&s[]=13457
Alle Werte und die Namen der Bücher, die sie repräsentieren
Oder Sie können es hier als JSON
Datei herunterladen
0
, 1819
, 8918
, 2664
... usw.0
für جميع الرواة
1819
أسماء بنت أبي بكر
darstellt8918
steht für عمر بن الخطاب
2664
steht für ابن عباس
/v1/api/hadith/search?value=جملة البحث&rawi[]=1819
/v1/api/hadith/search?value=جملة البحث&rawi[]=8918&rawi[]=2664
2665
ابن عباس أو أبو هريرة
8924
symbolisiert عمر بن الخطاب وأبو هريرة
264
symbolisiert أبو الدرداء وأبو أمامة وعبدالله بن عمر وابن عباس وجابر بن عبدالله
Alle Werte und die Namen der Erzähler, die sie repräsentieren
Oder Sie können es hier als JSON
Datei herunterladen
Von diesen endpoints
können alle verfügbaren Daten und die darin dargestellten Werte abgerufen werden
[
{
"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" : " القيمة "
}
]
}
]
Öffnen Sie ein Problem, wenn Sie auf ein Problem stoßen oder einen Vorschlag haben
Natürlich freuen wir uns über jeden unserer Beiträge ❤