- Laman utama
- API kod terbuka
API kod Nusuk terbuka
Kod rujukan di Umrah Codes percuma untuk mana-mana laman web atau inisiatif komuniti, tanpa daftar atau kunci API. Sila pautkan ke laman ini sebagai sumber dan ikut nota penggunaan wajar.
Fail tersedia
Setiap URL menerima permintaan GET dari mana-mana asal (CORS dibenarkan). https://umrahcodes.click/open-data/v1/
- latest.json200 kod terbaru, untuk muat semula kerap 11 KB
- codes.jsonSemua kod dengan masa ditambah, terbaru dahulu 5,974 KB
- codes.csvSemua kod sebagai hamparan 3,182 KB
- codes.txtSatu kod setiap baris 1,486 KB
- meta.jsonMasa kemas kini, bilangan dan checksum fail
Contoh
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 data
Setiap item dalam codes mengandungi kod dan masa ia ditambah (waktu Kaherah), atau null jika tidak diketahui. linkTemplate menunjukkan pautan yang membuka kod dalam Nusuk.
{
"schemaVersion": 1,
"updatedAt": "2026-11-12T09:03:38.478Z",
"count": 126794,
"source": "https://umrahcodes.click/",
"linkTemplate": "https://services.nusuk.sa/app/?p=27&id={code}",
"pinned": {
"code": "NG-pj62UbOJ",
"note": "Initiative owner code; priority order is provided separately."
},
"priority": {
"codes": [
"NG-fvlYyHhd",
"NG-ZiqRWvwe",
"NG-jK7U4cdd",
"NG-c9rA7DJH",
"NG-b974VVeP",
"NG-GTqkdX1D",
"NG-wYApFRqd",
"NG-ajoKxTFr"
],
"note": "These codes appear first on umrahcodes.click."
},
"codes": [
{
"code": "NG-fvlYyHhd",
"addedAt": null
},
{
"code": "NG-ZiqRWvwe",
"addedAt": null
}
]
}Penggunaan wajar
Fail dikemas kini dengan setiap kemas kini laman. Minta setiap fail paling kerap sekali setiap 15 minit dan simpan dalam cache; gunakan meta.json yang kecil untuk menyemak perubahan. Jika anda memaparkan kod di laman anda, sila pautkan ke Umrah Codes.
Nota
Kod ditambah oleh pengguna dan kesahannya dalam aplikasi Nusuk tidak dijamin. Ini inisiatif bebas, tidak bergabung dengan Nusuk atau mana-mana badan kerajaan.
Kod datang daripada pelawat dan inisiatif komuniti terbuka lain yang berkongsi kod Nusuk. Projek komuniti bebas untuk bertukar kod cabaran Nusuk. Tidak bergabung dengan aplikasi Nusuk atau mana-mana badan rasmi.

