A free RESTful API server that provides Duas and Dhikr following the Sunnah of the Prophet Muhammad (peace be upon him)
- Node.js
>= 20.x
- npm
-
Clone this repository
git clone https://github.com/fitrahive/dua-dhikr.git
-
Move to the repository directory
cd dua-dhikr
-
Install dependencies
npm ci
-
Run locally
-
Development mode
npm run dev
-
Production mode
-
Build first
npm run build
-
Start app
npm run start
-
-
The fastest way to use it privately on PaaS available
Base URL : http://localhost:3000
Endpoint | Description | Method |
---|---|---|
/languages |
Retrieve a list of supported languages | GET |
/categories |
Retrieve a list of dua & dhikr categories | GET |
/categories/:slug |
Retrieve a list of dua & dhikr based on a category | GET |
/categories/:slug/:id |
Retrieve details of a dua & dhikr based on category and id | GET |
Important
To retrieve data in supported language, use the Accept-Language
header. By default, it will use id
(Indonesian).
Warning
Currently, only Indonesian is ready to be served! For English and other languages, translation is in progress. Please wait, or help us to translate into other languages (except English, which is currently under development).
List of awesome projects (اللّٰهُمَّ بَارِكْ) powered by this API
List of server APIs ready to use publicly
Complete or add Duas and Dhikr data according to the authentic Sunnah that you know, ensure the data is authentic!
Warning
Fear Allah! Your contributions will be accounted for in the Hereafter!
- Fork this repository
- Open
data/dua-dhikr
and select an available category - Open the JSON file in the desired language, or add a new one with the
ISO 639
code - Make changes carefully!
- Commit the change using the command
npm run commit
. - Submit a pull-request
- Wait for us to perform the merge
title
contains the title of the Dua/Dhikr.arabic
contains the Dua/Dhikr in Arabic script.latin
contains the transliteration from Arabic script to Latin characters.translation
contains the translation in the desired language.notes
contains notes (e.g., Recite 3x).fawaid
contains the benefits or virtues of this Dua/Dhikr.source
contains the reference to the authentic Hadith used.
This project is licensed under MIT License.