Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/renomureza/quran-api-id

REST API Al-Quran Indonesia dengan terjemahan, tafsir (Kemenag, Quraish Shihab, Al-Jalalain), audio murottal (per surah dan ayat dari 6 qori), random ayat.
https://github.com/renomureza/quran-api-id

al-quran alquran indonesia indonesia-tafsir quran quran-api quran-audio quran-json quran-kemenag quran-translation quran-web tafsir tafsir-jalalayn tafsir-quraish tafsir-surahs

Last synced: about 2 months ago
JSON representation

REST API Al-Quran Indonesia dengan terjemahan, tafsir (Kemenag, Quraish Shihab, Al-Jalalain), audio murottal (per surah dan ayat dari 6 qori), random ayat.

Host: GitHub
URL: https://github.com/renomureza/quran-api-id
Owner: renomureza
License: mit
Created: 2021-11-08T05:35:22.000Z (almost 3 years ago)
Default Branch: main
Last Pushed: 2023-06-07T13:11:17.000Z (over 1 year ago)
Last Synced: 2024-05-21T11:54:10.025Z (4 months ago)
Topics: al-quran, alquran, indonesia, indonesia-tafsir, quran, quran-api, quran-audio, quran-json, quran-kemenag, quran-translation, quran-web, tafsir, tafsir-jalalayn, tafsir-quraish, tafsir-surahs
Language: JavaScript
Homepage: https://quran-api-id.vercel.app
Size: 9.83 MB
Stars: 115
Watchers: 1
Forks: 48
Open Issues: 17
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

awesome-made-by-indonesian - Quran API ID - `REST API Al-Quran Indonesia dengan terjemahan, tafsir (Kemenag, Quraish Shihab, Al-Jalalain), audio murottal (per surah dan ayat dari 6 qori), random ayat.` *by [R.M. Reza](https://github.com/renomureza)* (Q)
made-in-indonesia - Quran API ID - `REST API Al-Quran Indonesia dengan terjemahan, tafsir (Kemenag, Quraish Shihab, Al-Jalalain), audio murottal (per surah dan ayat dari 6 qori), random ayat.` *by [R.M. Reza](https://github.com/renomureza)* (Q)

README

        


  

    

  

  Quran API ID

  

    REST API Al-Quran Indonesia dengan terjemahan, tafsir (Kemenag, Quraish Shihab, Al-Jalalain), audio murottal (per surah dan ayat dari 6 qori), random ayat.

  

   

    Demo · Lapor Bug · Request Fitur

  

  

    

  

  

    

  

  

    

  

  

    

  

  

  

  



## Fitur

Quran API ID merupakan REST API Al-Quran yang menyajikan data Al-Quran dalam bahasa Indonesia. Datanya berasal dari berbagai sumber, data tersebut digabungkan menjadi satu file JSON dengan struktur baru.

Berikut beberapa fitur Quran API ID:

- **6 Audio (murottal)**: murrotal surah yang mencakup semua ayat (dengan suara terjemahan), murottal setiap ayat dari 6 qori: Shaykh Mishari Alafasy, Ahmed ibn Ali al-Ajamy, Husary (Mujawwad), Minshawi, Muhammad Ayyoub, dan Muhammad Jibreel.

- **3 Tafsir**: tafsir setiap ayat dari Kemenag (versi panjang dan pendek), Quraish Shihab, dan Al-Jalalain.

- **Random Ayat**: untuk mendapatkan data ayat secara random.

- **Metadata**: juz, halaman, manzil, ruku, sajda, dan lainnya.

- **Deskripsi Surah**: deskripsi singkat setiap surah seperti golongan surah, jumlah ayat, asal-usul namanya.

- **Gambar Ayat**: ayat dalam gambar.

- _Punya ide attau butuh fitur lain? ajukan [permintaan fitur](https://github.com/renomureza/quran-api-id/issues)_.

## Endpoints

| Endpoint                                 | Contoh                                                                      | Deskripsi                                         |

| ---------------------------------------- | --------------------------------------------------------------------------- | ------------------------------------------------- |

| `/surahs`                                | [`/surahs`](https://quran-api-id.vercel.app/surahs)                         | daftar surah.                                     |

| `/surahs/{nomorSurah}`                   | [`/surahs/112`](https://quran-api-id.vercel.app/surahs/112)                 | surah tertentu berdasarkan nomor surah (1 - 114). |

| `/surahs/{nomorSurah}/ayahs`             | [`/surahs/112/ayahs`](https://quran-api-id.vercel.app/surahs/112/ayahs)     | semua ayat dari surah tertentu tertentu.          |

| `/surahs/{nomorSurah}/ayahs/{nomorAyat}` | [`/surahs/112/ayahs/2`](https://quran-api-id.vercel.app/surahs/112/ayahs/2) | ayat dari surah tertentu.                         |

| `/random`                                | [`/random`](https://quran-api-id.vercel.app/random)                         | random ayat.                                      |

## Sumber Data

Semua data disimpan di [folder data](https://github.com/renomureza/quran-api-id/tree/main/data), data di folder tmp adalah data mentah, `quran.json` adalah data yang sudah jadi.

Berikut beberapa sumber data yang digunakan:

- [Al-Quran Kemenag](https://quran.kemenag.go.id) (prioritas): nama surah, terjemahan ayat, tafsir Kemenag, dll.

- [Al Quran Cloud](https://alquran.cloud): Metadata, audio ayah.

- [Tanzil](https://tanzil.net/docs/): Tafsir Quraish Shihab dan Al-Jalalain.

- [Al-Quran-ID-API](https://github.com/bachors/Al-Quran-ID-API): deskripsi surah dan audio surah.

## Daftar Perintah (Command)

- `yarn start` - menjalankan server.

- `yarn dev` - menjalankan server pengembangan.

- `yarn build:quran` - untuk membangun ulang data quran utama.

## License

Licensed under [MIT](https://opensource.org/licenses/MIT).