- Mal
- API ya kodên Nusukê
API-ya kodên Nusuk vekin
Kodên referansê yên li ser Umrah Codes ji bo her malper an însiyatîfa civatê belaş in, bêyî qeydkirin an mifteya API-yê. Ji kerema xwe malperê wekî çavkaniyê ve girêdin û têbîniya karanîna adil bişopînin.
Pelên berdest
Her URL daxwazên GET ji her eslê xwe qebûl dike (CORS çalak kirin). https://umrahcodes.click/open-data/v1/
- latest.json200 kodên herî paşîn, ji bo nûvekirina pir caran 11 KB
- codes.jsonHemî kodên bi demê re hatine zêdekirin, yekem herî nû 5,974 KB
- codes.csvHemî kodên wekî peldankek 3,182 KB
- codes.txtHer rêzek kodek 1,486 KB
- meta.jsonDemjimêr nûve bikin, hejmartin û kontrolên pelan bikin
Examples
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.txtForma daneyê
Her babetek di kodan de kod û dema lê zêdekirî ye (dema Qahîreyê), an heke nenas be betal e. linkTemplate girêdana ku kodek di Nusuk de vedike nîşan dide.
{
"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
}
]
}Bikaranîna adil
Bi her nûvekirina malperê re pelan nûve dikin. Her pelê herî zêde her 15 hûrdem carekê daxwaz bikin û wê cache bikin; meta.json piçûk bikar bînin ku ji bo guhertinan kontrol bikin. Ger hûn kodên li ser malpera xwe nîşan bidin, ji kerema xwe bi Umrah Codes ve girêdin.
Têbînî
Kod ji hêla bikarhêneran ve têne zêdekirin û derbasdariya wan di sepana Nusuk de ne garantî ye. Ev însiyatîfek serbixwe ye, ne girêdayî Nusuk an saziyek hukûmetê ye.
Kod ji mêvanan û projeyên civakî yên vekirî têne komkirin. Projeyeke civakî ya serbixwe ji bo parvekirina kodên pêşbaziya Nusukê. Ne girêdayî sepanê an saziyek fermî ye.

