A random hadith

Extraits de code

curl "https://api.oanor.com/hadith-api/v1/random" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/hadith-api/v1/random", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/hadith-api/v1/random");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/hadith-api/v1/random",
    headers={"x-oanor-key": "oanor_test_..."}
)

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "data": {
        "hadith": {
            "text": "Narrated Ibn `Abbas:A man came to the Prophet (ﷺ) and said to him, \"My sister vowed to perform the Hajj, but she died (before fulfilling it).\" The Prophet (ﷺ) said, \"Would you not have paid her debts if she had any?\" The man said, \"Yes.\" The Prophet (ﷺ) said, \"So pay Allah's Rights, as He is more entitled to receive His rights",
            "grades": [],
            "number": 6699,
            "edition": "eng-bukhari",
            "reference": {
                "book": 83,
                "hadith": 76
            },
            "arabic_number": 6699
        },
        "collection": "Sahih al Bukhari"
    },
    "meta": {
        "timestamp": "2026-06-08T01:19:29.119Z",
        "request_id": "10e81e01-b5f4-4db5-a6eb-045f2e2a2d90"
    },
    "status": "ok",
    "message": "Random hadith retrieved successfully",
    "success": true
}