dorar hadith api

API хадисов Dorar.net

Мир, благословение и милость Божия пребудут с вами

Некоторое время назад я пытался использовать API зубного жемчуга.
Но я столкнулся с некоторыми трудностями, в том числе с тем, что API работает только с JSONP, и вы не сможете справиться с ним обычными способами из-за CORS.

Если вам удастся избежать CORS с помощью JSONP вы получите выходные данные в формате HTML . Кроме того, не существует documentation или документа, объясняющего детали этого API и способы работы с ним.

Я решил создать промежуточный API , который позволяет избежать проблемы CORS и предоставляет вам данные в формате JSON вместе с подробным объяснением API и того, как его использовать.
Помимо наличия некоторых дополнительных функций, которых нет в официальном API

тревога

• Каждый поиск cache на 5 секунд.
• Существует ограничение на использование: 100 поисков в день на IP

Вы можете редактировать их из файла config.js.

Запустите API

1. fork или clone этот проект
2. Установить dependencies

npm install

3. Проверьте файл config.js и измените все, что хотите.
4. Запустите API

npm start

5. API будет доступен по следующей ссылке.

http://localhost:5000

6. Используйте его на localhost по своему усмотрению или загрузите на свой хостинг или сервер.

Документация

Почтальон

Ссылка: Почтальон

• Используйте Postman , чтобы узнать, как работать с API , и посмотреть примеры.
• fork collection , чтобы использовать ее по своему усмотрению.
• Не забудьте изменить environment на dev и вы можете изменить ссылку на переменную {{url}} если вы ее меняли или меняли port

OpenAPI v3 (Сваггер)

Документация по API

Чтобы просмотреть интерактивную документацию API:

1. Запустите сервер:

    npm run dev
   

2. Откройте браузер и перейдите по адресу:

    http://localhost:5000/api-docs
   

Здесь вы найдете пользовательский интерфейс Swagger, который позволяет вам исследовать все доступные конечные точки и тестировать API прямо из браузера.

Конечные точки

API содержит набор endpoint

• Когда endpoint начинается с /api , она выполняет поиск через официальный API Durar Al-Suniya.
• Когда endpoint начинается с /site , именно так она и ищется на странице поиска Durar Al-Sunniyya.

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

Поиск хадисов дает 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/сайт/хадис/похожий/: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/сайт/доля/текст/:текст

Искать объяснение одного хадиса по методу данного текста.

Отформатируйте ответ как 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/сайт/мохдит/: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
  Это приведет к поиску результатов поиска на третьей странице, то есть третьей группе результатов поиска.
• Значением по умолчанию будет страница одна 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 отсюда.

т

• Определите область поиска
• Этими диапазонами являются: جميع الأحاديث , الأحاديث المرفوعة , الأحاديث القدسية , آثار الصحابة , شروح الأحاديث
• Его значения: * , 0 , 1 , 2 , 3
  Для поиска جميع الأحاديث это будет t=*
  Для поиска الأحاديث المرفوعة t=0
  Для поиска الأحاديث القدسية t=1
  Для поиска آثار الصحابة t=2
  Для поиска شروح الأحاديث t=3
• Пример: /v1/api/hadith/search?value=جملة البحث&t=1
  Таким образом, он будет искать только те священные хадисы, которые соответствуют поисковому запросу.

Все значения и диапазоны поиска, которые они представляют
Или вы можете получить его в виде файла JSON отсюда.

д[]

• Определите степень хадиса, является ли он достоверным или слабым.
• Его значения: 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 отсюда.

м[]

• Укажите названия нужных обновлений
• Он имеет несколько значений, в том числе: 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 отсюда.

с[]

• Выберите книги, которые хотите найти
• Он имеет несколько значений, в том числе: 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
  Таким образом, он будет искать только те хадисы, которые были упомянуты в моей книге «Сорок Навави» и книге «Сахих аль-Бухари».

Все ценности и названия книг, которые они представляют
Или вы можете получить его в виде файла 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" : " القيمة "
      }
    ]
  }
]

Есть проблема или у вас есть предложение?

Откройте проблему, если столкнулись с проблемой или у вас есть предложение.

Вклад

Конечно, мы приветствуем любой наш вклад ❤