DAT JavaScript / TypeScript مكتبة
GitHub npmالتثبيت
بدء سريع
يجلب هذا التدفق الكامل الشهادات من CMS، وينشئ DAT يحتوي بيانات JSON، ثم يتحقق منه.
خطوة بخطوة
1. الاتصال بـ CMS
تستخدم خدمة الإصدار رمزًا للشهادات الكاملة. وتمنع المزامنة الفورية عند بدء التشغيل الإصدار قبل توفر الشهادات.
2. إصدار DAT
يضع هذا المثال JSON عامًا في plain ومعلومات مستخدم محمية بصيغة JSON في secure.
3. التحقق من DAT
يتحقق parse من انتهاء الصلاحية والتوقيع ثم يفك تشفير secure. لا تستخدم إلا payload أعيد بعد تحقق ناجح.
الدوال الأساسية
| الدالة | الغرض |
|---|---|
syncOrThrow() | يزامن الشهادات فورًا. |
issue(plain, secure) | ينشئ string لـ DAT بصورة غير متزامنة. |
parse(dat) | يتحقق من DAT ويعيد DatPayload. |
lastError() | يعيد آخر خطأ في المزامنة. |
مناطق البيانات
plain: بايتات موقّعة لكنها غير مشفّرة.secure: بايتات مشفّرة.payload: لا تثق به إلا بعد نجاحparse.
خيارات غير JSON
تستخدم الأمثلة صيغة JSON المألوفة. وللمعالجة الأسرع، يمكن للبيانات الثنائية تجنب تسلسل JSON وتحليله مع تقليل حجم البيانات.
خزّن القيم البسيطة كنص، أو ضع البيانات المنظمة بصيغ ثنائية مثل Protobuf أو MessagePack داخل plain وsecure.
مرّر Uint8Array أو ArrayBuffer واسترجع البايتات الأصلية عبر plainBytes وsecureBytes.
خدمات التحقق فقط
تستخدم الخدمة التي لا تصدر DAT خيار verify-only ورمز verify-only، ولا تستدعي إلا parse.
الإغلاق والأخطاء
استدعِ stop() عند الإغلاق لتنظيف المؤقتات والطلبات الجارية.
استخدم رموز الخطأ وتصنيفات إعادة المحاولة بدلًا من رسائل الخطأ.