البيانات المفتوحة والتضمين
جميع جوازات AsOf بيانات مفتوحة. يمكن لأي موقع أو تطبيق قراءتها وعرضها والبقاء محدَّثًا — دون مفتاح ودون تسجيل.
العناوين
/api/v1/index.json | قائمة الأصول والعدّادات ووقت آخر تشغيل |
/api/v1/passports/{id}.json | جواز واحد: حقائق مع اقتباسات ومصادر، وقياسات من سلسلة الكتل، ومصادر مؤرشفة |
/api/v1/changes.json | التغييرات المرصودة في وثائق المصادر (مقاطع قصيرة) |
/api/v1/schema.json | مخطط JSON لصيغة الجواز |
/feed.xml | سجل التغييرات بصيغة موجز Atom |
يمكن قراءة الملفات من أي موقع (CORS مفعّل). وهي ملفات ثابتة، فلا حدود لعدد الطلبات من جهتنا.
مثال
const r = await fetch("https://asof.pro/api/v1/passports/paxg.json");
const p = await r.json();
console.log(p.name, "as of", p.as_of, p.counts);
// → PAX Gold as of 2026-10-23 { confirmed: 16, claimed: 1, unknown: 0 }تضمين بطاقة الجواز
الصق سطرين في أي صفحة. تتحدّث البطاقة تلقائيًا كلما أعاد AsOf النشر. دون ملفات تعريف الارتباط ودون تتبّع.
<div data-asof="paxg" data-lang="ar"></div>
<script src="https://asof.pro/embed.js" async></script>حيث لا يُسمح بالسكربتات، استخدم iframe:
<iframe src="https://asof.pro/ar/embed/paxg/" title="AsOf passport"
style="width:100%;max-width:560px;height:460px;border:0"></iframe>معاينة
مدى الحداثة
تُحدَّث بعد كل تشغيل يومي (05:00 بالتوقيت العالمي) وعندما يعتمد المحرر حقائق جديدة. كل جواز يتضمن as_of، وملف index.json يتضمن generated_at.
الإصدارات
يبقى /api/v1 متوافقًا: قد تُضاف حقول، لكنها لا تُعاد تسميتها ولا تُحذف. التغييرات غير المتوافقة تحصل على /api/v2، ويستمر v1 في العمل ستة أشهر على الأقل.
الترخيص
بيانات AsOf والصيغة مرخّصة بموجب CC BY 4.0. انسب المصدر إلى «AsOf by Diikun LAB» مع رابط إلى الجواز. الاقتباسات مقاطع قصيرة من وثائق المُصدِرين وتبقى نصّهم.
ما نطلبه
ليس شرطًا في الترخيص بل طلب: اعرض تاريخ «بتاريخ»، وأبقِ «غير معروف» ظاهرًا، ولا تحوّل البيانات إلى درجات أو تصنيفات أو نصائح.