Mwanzo
API ya misimbo huria

API huria ya misimbo ya Nusuk

Misimbo ya rufaa kwenye Umrah Codes ni bure kwa tovuti yoyote au mpango wa jamii, bila usajili wala ufunguo wa API. Tafadhali weka kiungo cha tovuti kama chanzo na ufuate maelezo ya matumizi ya haki.

Misimbo: 126,794Imesasishwa: 2026-11-12 09:03 UTC

Faili zinazopatikana

Kila URL inakubali maombi ya GET kutoka chanzo chochote (CORS imewezeshwa). https://umrahcodes.click/open-data/v1/

latest.jsonMisimbo 200 mipya zaidi, kwa kusasisha mara kwa mara 11 KB
codes.jsonMisimbo yote na muda ulioongezwa, mipya kwanza 5,974 KB
codes.csvMisimbo yote kama jedwali 3,182 KB
codes.txtMsimbo mmoja kwa kila mstari 1,486 KB
meta.jsonMuda wa kusasisha, idadi na checksum za faili

Mifano

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.txt

Muundo wa data

Kila kipengee katika codes kina msimbo na muda ulioongezwa (saa za Cairo), au null kama haijulikani. linkTemplate inaonyesha kiungo kinachofungua msimbo kwenye 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
    }
  ]
}

Matumizi ya haki

Faili husasishwa kila tovuti inaposasishwa. Omba kila faili mara moja kila dakika 15 zaidi na uihifadhi; tumia meta.json ndogo kuangalia mabadiliko. Ukionyesha misimbo kwenye tovuti yako, tafadhali weka kiungo cha Umrah Codes.

Kumbuka

Misimbo huongezwa na watumiaji na uhalali wake kwenye programu ya Nusuk hauhakikishwi. Huu ni mpango huru, hauhusiani na Nusuk wala taasisi yoyote ya serikali.

Tazama misimbo ya Nusuk

Misimbo hutoka kwa wageni na mipango mingine huru ya jamii inayoshiriki misimbo ya Nusuk. Mradi huru wa jamii wa kubadilishana misimbo ya shindano la Nusuk. Hauhusiani na programu ya Nusuk wala taasisi yoyote rasmi.