- Accueil
- API ouverte des codes
API ouverte des codes Nusuk
Les codes de Umrah Codes sont gratuits pour tout site ou initiative communautaire, sans inscription ni clé. Merci de citer le site comme source et de respecter l’usage raisonnable.
Fichiers disponibles
Chaque URL accepte les requêtes GET depuis n’importe quelle origine (CORS activé). https://umrahcodes.click/open-data/v1/
- latest.jsonLes 200 plus récents 10 KB
- codes.jsonTous les codes avec la date, les plus récents d’abord 2,463 KB
- codes.csvTous les codes en tableau 1,332 KB
- codes.txtUn code par ligne 604 KB
- meta.jsonDate, total et empreintes des fichiers
Exemples
const res = await fetch('https://umrahcodes.click/open-data/v1/latest.json');
const data = await res.json();
console.log(data.count, data.updatedAt);
for (const { code } of data.codes) {
const link = data.linkTemplate.replace('{code}', code);
console.log(code, link);
}import requests
data = requests.get("https://umrahcodes.click/open-data/v1/codes.json", timeout=30).json()
print(data["count"], data["updatedAt"])
for item in data["codes"][:5]:
print(item["code"], item["addedAt"])<?php
$data = json_decode(file_get_contents('https://umrahcodes.click/open-data/v1/latest.json'), true);
foreach (array_slice($data['codes'], 0, 5) as $item) {
echo $item['code'], PHP_EOL;
}curl -s https://umrahcodes.click/open-data/v1/codes.txt -o nusuk-codes.txtFormat des données
Chaque élément de codes contient le code et l’heure d’ajout (heure du Caire), ou null si elle est inconnue. linkTemplate indique le lien pour l’ouvrir dans Nusuk.
{
"schemaVersion": 1,
"updatedAt": "2026-11-05T14:05:14.848Z",
"count": 51565,
"source": "https://umrahcodes.click/",
"linkTemplate": "https://services.nusuk.sa/app/?p=27&id={code}",
"pinned": {
"code": "NG-pj62UbOJ",
"note": "Initiative owner code, shown first on umrahcodes.click"
},
"codes": [
{
"code": "NG-pj62UbOJ",
"addedAt": "2026-11-03 02:43"
},
{
"code": "NG-Uq5nWX7P",
"addedAt": null
}
]
}Usage raisonnable
Demandez chaque fichier au plus une fois toutes les 15 minutes et mettez-le en cache ; utilisez meta.json pour détecter les changements. Si vous affichez les codes, mettez un lien vers Umrah Codes.
Remarque
Les codes sont ajoutés par des utilisateurs et leur validité n’est pas garantie. Initiative indépendante, sans lien avec Nusuk.
Les codes viennent des visiteurs et d’autres initiatives communautaires ouvertes qui partagent des codes Nusuk. Initiative communautaire indépendante d’échange de codes du défi Nusuk. Non affiliée à l’application Nusuk ni à un organisme officiel.
Voir les codes Nusuk