Qoran.nl
S

QoranNL API

QoranNL API Documentatie

Een RESTful API voor ontwikkelaars die toegang willen tot betrouwbare Koran data, vertalingen en tafsir. Gebouwd met de intentie om islamitische kennis toegankelijk en deelbaar te maken.

Jouw API Toegang

Beheer hier je persoonlijke API key.

Authenticatie

Authenticatie verloopt via een Bearer Token. Voeg je API key toe aan de header van elk request.

bash
curl -H "Authorization: Bearer YOUR_API_KEY" https://qoran.nl/api/v1/suwar

Of via een query parameter (minder veilig, niet aanbevolen voor productie):

?api_key=YOUR_API_KEY

Alle Surahs

Haal een lijst op van alle 114 hoofdstukken (Surahs) met basisinformatie.

GET/api/v1/suwar

Request

bash
curl -H "Authorization: Bearer YOUR_API_KEY" "https://qoran.nl/api/v1/suwar"

Response Voorbeeld

{
  "code": 200,
  "status": "OK",
  "data": [
    {
      "number": 1,
      "name": "Al-Fatihah",
      "englishName": "The Opening",
      "englishNameTranslation": "De Opening",
      "numberOfAyahs": 7,
      "revelationType": "Meccan"
    },
    ...
  ]
}

Surah Detail

Haal de volledige inhoud van een Surah op, inclusief Arabische tekst en optionele vertalingen/tafsir.

GET/api/v1/surah/{id}

Query Parameters

editionOptioneel. Comma-gescheiden lijst van vertaling/tafsir IDs (bijv. nl_siregar,en_sahih). Standaard is Qoran.nl (nl), met fallback naar nl_siregar.tafaseerOptioneel. Zet op true om alle gekoppelde tafsirs op te halen.

Request

bash
curl -H "Authorization: Bearer YOUR_API_KEY" "https://qoran.nl/api/v1/surah/1?edition=nl_siregar"

Response Voorbeeld

{
  "code": 200,
  "status": "OK",
  "data": {
    "number": 1,
    "name": "Al-Fatihah",
    "englishName": "The Opening",
    "ayahs": [
      {
        "number": 1,
        "text": "بِسْمِ ٱللَّهِ ٱلرَّحْمَٰنِ ٱلرَّحِيمِ",
        "numberInSurah": 1,
        "translations": {
          "nl": {
             "text": "In de Naam van Allah...",
             "author": "Qoran.nl"
          },
          "nl_siregar": "In de naam van Allah..."
        }
      }
      ...
    ]
  }
}

Ayah Detail

Haal één specifiek vers op.

GET/api/v1/ayah/{surah}/{ayah}

Request

bash
curl -H "Authorization: Bearer YOUR_API_KEY" "https://qoran.nl/api/v1/ayah/2/255"

Response Voorbeeld

{
  "code": 200,
  "status": "OK",
  "data": {
    "number": 262,
    "text": "ٱللَّهُ لَآ إِلَٰهَ إِلَّا هُوَ ٱلْحَىُّ ٱلْقَيُّومُ...",
    "surah": {
      "number": 2,
      "name": "Al-Baqarah",
      ...
    },
    ...
  }
}

Beschikbare Edities

Een overzicht van alle beschikbare vertalingen en tafaseer om te gebruiken in je requests.

GET/api/v1/editions
Lijst laden...

Rate Limiting & Fair Use

Om de stabiliteit van Qoran.nl te garanderen voor iedereen, hanteren we een standaard limiet van 50 requests per dag voor gratis keys.

Meer nodig?

Stuur een mail naar [email protected] met je projectomschrijving. Wij verhogen limieten graag kostenloos voor nuttige Islamitische projecten.

Database Dump

Liever alles offline? Wij delen onze volledige database (MongoDB/JSON) met serieuze ontwikkelaars.

Aanvragen via Mail

Bevat alle ayah's, vertalingen, tafsir en metadata.