- الرئيسية
- واجهة بيانات الأكواد (API)
واجهة بيانات أكواد نسك المفتوحة
أكواد الإحالة في Umrah Codes متاحة لأي موقع أو مبادرة مجتمعية مجانًا، دون تسجيل أو مفتاح API. كل ما نطلبه رابط إلى الموقع كمصدر، والالتزام بالاستخدام العادل.
الملفات المتاحة
كل الروابط تقبل طلبات GET من أي نطاق (CORS مفتوح). https://umrahcodes.click/open-data/v1/
- latest.jsonأحدث 200 كود، مناسب للتحديث المتكرر 10 KB
- codes.jsonكل الأكواد مع وقت الإضافة، الأحدث أولًا 2,463 KB
- codes.csvكل الأكواد بصيغة جدول 1,332 KB
- codes.txtكود في كل سطر 604 KB
- meta.jsonوقت التحديث وعدد الأكواد وبصمة كل ملف
أمثلة
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شكل البيانات
كل عنصر في codes فيه الكود ووقت إضافته بتوقيت القاهرة، أو null إذا لم يكن الوقت معروفًا. الحقل linkTemplate يوضح رابط فتح الكود في نسك.
{
"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
}
]
}الاستخدام العادل
تتحدّث الملفات عند كل تحديث للموقع. اطلب كل ملف مرة كل 15 دقيقة على الأكثر واحفظ النتيجة عندك، واستخدم meta.json الصغير لمعرفة هل تغيّر شيء. وإذا عرضت الأكواد في موقعك، فأضف رابطًا إلى Umrah Codes.
تنبيه
الأكواد يضيفها المستخدمون، ولا نضمن صلاحية أي كود داخل تطبيق نسك. الموقع مبادرة مستقلة لا تتبع نسك ولا أي جهة رسمية.
تُجمع الأكواد من الزوار ومن مبادرات مجتمعية مفتوحة أخرى لتبادل أكواد نسك. مبادرة مجتمعية مستقلة لتبادل أكواد تحدي نسك، لا تتبع تطبيق نسك ولا أي جهة رسمية.
تصفّح أكواد نسك