API d'horaires de prière gratuite, sans clé d'API
API d'horaires de prière gratuite, sans clé ni inscription. Horaires du jour en JSON par latitude et longitude, flux iCal, recherche de ville, mosquées.
Sur cette page
L’API d’horaires de prière sur qurangallery.com/prayer/developers est gratuite et ne demande ni clé d’API ni inscription. Quatre points d’accès publics renvoient les horaires de prière du jour en JSON pour une latitude et une longitude, un flux iCal auquel s’abonner, la recherche de ville et les mosquées proches.
Chaque point d’accès se trouve sous https://qurangallery.com/prayer. Une entrée incorrecte renvoie 400 et trop de requêtes renvoient 429.
Horaires de prière pour un lieu
GET /api/times renvoie le Fajr, le lever du soleil, le Dhuhr, l’Asr, le Maghrib et l’Isha du jour pour un couple de coordonnées, ainsi que le Fajr de demain. Chaque heure est un instant ISO 8601 en UTC. Une heure qui n’existe pas à cette latitude ce jour-là est omise.
curl 'https://qurangallery.com/prayer/api/times?lat=21.4225&lng=39.8262'Paramètres :
lat— obligatoire. Latitude en degrés décimaux.lng— obligatoire. Longitude en degrés décimaux.method— facultatif. Identifiant de la méthode de calcul, par exemple mwl, isna ou karachi. Par défaut : la méthode de la ville la plus proche.asr— facultatif. standard ou hanafi, qui fixe l’heure de l’Asr. Par défaut : la convention habituelle du pays de la ville la plus proche.hlr— facultatif. Règle des hautes latitudes : auto, middle-of-the-night, seventh-of-the-night ou twilight-angle. Par défaut : auto.faetia— facultatifs. Angle personnalisé du Fajr et de l’Isha en degrés, de 10 à 25. Par défaut : l’angle propre à la méthode.
La réponse, abrégée :
{
"date": "2026-10-31",
"times": [
{ "name": "fajr", "time": "2026-10-31T02:06:00.000Z", "isCurrent": false, "isNext": true },
{ "name": "sunrise", "time": "2026-10-31T03:23:00.000Z", "isCurrent": false, "isNext": false },
{ "name": "dhuhr", "time": "2026-10-31T09:04:00.000Z", "isCurrent": false, "isNext": false },
{ "name": "asr", "time": "2026-10-31T12:20:00.000Z", "isCurrent": false, "isNext": false },
{ "name": "maghrib", "time": "2026-10-31T14:45:00.000Z", "isCurrent": false, "isNext": false },
{ "name": "isha", "time": "2026-10-31T16:15:00.000Z", "isCurrent": false, "isNext": false }
],
"fajrTomorrow": "2026-11-01T02:06:00.000Z"
}La date est celle du jour local des coordonnées. Les horaires de prière n’ont pas de limite distincte : mettez donc en cache la réponse de chaque lieu pour la journée au lieu d’appeler à chaque affichage de page.
Recherche de ville
GET /api/location/search transforme un nom de lieu en coordonnées, code de pays et fuseau horaire. Elle interroge d’abord la propre liste de villes de l’application, et une requête sans correspondance renvoie un tableau vide.
curl 'https://qurangallery.com/prayer/api/location/search?q=Makkah'q— obligatoire. Le nom du lieu, jusqu’à 200 caractères.
[
{
"lat": 21.4266,
"lon": 39.8256,
"displayName": "Makkah, Saudi Arabia",
"countryCode": "SA",
"timezone": "Asia/Riyadh"
}
]Prenez lat et lon du premier résultat et passez-les comme lat et lng au point d’accès des horaires de prière.
Flux d’agenda (iCal)
GET /api/calendar/feed.ics renvoie un fichier text/calendar auquel on peut s’abonner, avec les horaires de prière et les fêtes islamiques, un mois par défaut et jusqu’à 12 mois. Ajoutez son URL comme abonnement d’agenda dans Google Agenda, Apple Agenda ou Outlook.
curl 'https://qurangallery.com/prayer/api/calendar/feed.ics?lat=21.4225&lng=39.8262'Obligatoires : lat et lng. Facultatifs : method, asr, hlr, fa, ia comme ci-dessus, plus :
authority— autorité du calendrier hégirien pour les fêtes, par exemple umm_al_qura ou diyanet. Par défaut : l’autorité du pays de la ville la plus proche.months— nombre de mois couverts par le flux, de 1 à 12. Par défaut : 1.alarm— minutes avant chaque prière pour le rappel, de 0 à 120. 0 signifie aucune alarme. Par défaut : 10.sunrise,travel,ramadan,jumuah,busy— mettez 1 pour activer respectivement le lever du soleil, la note de voyage, les événements du Ramadan, la Jumu’ah le vendredi ou le temps occupé. Par défaut : désactivé.
Vous pouvez aussi créer le même flux sans code sur la page de synchronisation d’agenda. Le flux d’agenda autorise 30 requêtes par minute.
Mosquées proches
GET /api/mosques/nearby liste les mosquées autour d’un point, de la plus proche à la plus éloignée, à partir des données d’OpenStreetMap. La distance est en mètres. La réponse est 503 lorsque les services de données cartographiques sont indisponibles.
curl 'https://qurangallery.com/prayer/api/mosques/nearby?lat=21.4225&lng=39.8262&radius=2000'latetlng— obligatoires.radius— facultatif. Rayon de recherche en mètres, de 100 à 50000. Par défaut : 2000.
[
{
"id": 1234567,
"name": "Example Mosque",
"lat": 21.4231,
"lng": 39.8269,
"address": "Example Street 12",
"distance": 96.4
}
]La couverture dépend d’OpenStreetMap. La vue dans l’application des mêmes données est décrite sur la page des mosquées.
Limites de débit
Les limites comptent les requêtes par adresse IP sur une fenêtre d’une minute. Au-delà de la limite, vous recevez HTTP 429.
- Horaires de prière : pas de limite propre.
- Flux d’agenda : 30 requêtes par minute.
- La recherche de ville et les mosquées proches partagent un même quota : 30 requêtes par minute.
L’utiliser depuis un navigateur
L’API n’envoie aucun en-tête CORS : une page d’un autre site ne peut donc pas lire la réponse. Appelez-la plutôt depuis votre serveur. Si vous voulez seulement afficher les horaires sur un site web, utilisez le widget pour site web : un iframe, sans code et sans clé.
Voir aussi
- Widget pour site web — horaires de prière ou calendrier hégirien en iframe.
- Méthodes de calcul — quelle est la méthode par défaut, et les autres options.
- Synchronisation d’agenda — le même flux, créé à partir d’un formulaire.
Étapes suivantes
Questions
L'API d'horaires de prière est-elle gratuite, et faut-il une clé d'API ?
Oui, elle est gratuite et ne demande ni clé, ni compte, ni inscription. Envoyez une requête GET au point d'accès avec les paramètres, en respectant les limites de débit.
Comment obtenir les horaires de prière à partir du nom d'une ville ?
Appelez le point d'accès de recherche de ville avec q, prenez lat et lon du premier résultat, puis passez-les comme lat et lng au point d'accès des horaires de prière.
Quelle méthode de calcul et quelle règle d'Asr l'API utilise-t-elle par défaut ?
Sans method, elle utilise la méthode de la ville la plus proche de vos coordonnées. Sans asr, elle utilise la convention d'Asr habituelle du pays de cette ville. Envoyez les deux pour les fixer.
Pourquoi une prière manque-t-elle dans la réponse ?
Près des pôles, le soleil peut ne jamais atteindre l'angle du Fajr ou de l'Isha : il n'y a alors aucune heure à donner. L'API omet cette prière plutôt que de renvoyer une date invalide.
Puis-je appeler l'API depuis JavaScript dans le navigateur ?
L'API n'envoie aucun en-tête CORS : une page d'un autre site ne peut donc pas lire la réponse. Appelez-la depuis votre serveur, ou utilisez le widget intégrable, qui ne demande aucun code.
Quelles sont les limites de débit ?
Les limites comptent les requêtes par adresse IP sur une fenêtre d'une minute. Le flux d'agenda autorise 30 requêtes par minute, et la recherche de ville et les mosquées proches partagent un même quota de 30 par minute. Au-delà, vous recevez HTTP 429.
À quelle fréquence dois-je demander les horaires de prière ?
Une fois par lieu et par jour suffit. Conservez la réponse et calculez vous-même les comptes à rebours ; le Fajr de demain est inclus pour les heures après l'Isha.
Existe-t-il un flux iCal ?
Oui. Le flux d'agenda renvoie un fichier .ics auquel on peut s'abonner, avec les horaires de prière et les fêtes islamiques, un mois par défaut et jusqu'à 12 mois avec le paramètre months.