تنزيل وتشغيل أمثلة الإرسال وOAuth

ما الذي ستنزله؟#

الأرشيف يحتوي CLI للإرسال ومتابعة الحالة، وموقع localhost لتجربة OAuth، وتعليمات عربية وإنجليزية واختبارات. الأسرار والرسائل ليست داخله. ملف معلومات النسخة يربط التنزيل بمصدر البناء وبصمته.

١. فك الضغط وشغّل الاختبارات#

تحتاج Node.js 22.13 أو أحدث. فك الضغط وافتح مجلد rasel-integrations في الطرفية، ثم شغّل npm test. لا تحتاج npm install؛ الأمثلة تعتمد على مكتبات Node القياسية. الاختبارات تستخدم خدمات محلية وهمية ولا ترسل بريدًا حقيقيًا.

npm test

٢. شغّل إرسال حدث واحد#

1. انسخ .env.example إلى .env، وmessage.example.json إلى message.local.json.
2. ضع مفتاح مشروعك في .env واستبدل عناوين المثال بمرسل من دومين مشروعك ومستلم اختبار.
3. نفّذ أمر الإرسال، ثم استخدم المعرّف المعاد لقراءة الحالة. احتفظ بنفس الحدث عند ضياع الرد.

node --env-file=.env send.mjs send order-123-confirmation message.local.json
node --env-file=.env send.mjs status RETURNED_MESSAGE_UUID

المثال يسجل هوية الحدث والبصمة والمعرّف فقط، ويمنع اختلاف المحتوى لنفس الحدث. لا يرسل unknown تلقائيًا. لو أغلقت العملية بالقوة، اتبع تعليمات قفل الحدث في README قبل إزالة أي قفل متبقٍ.

٣. جرّب الموافقة والقراءة والإلغاء#

1. سجّل تطبيق OAuth ورابط http://localhost:4318/callback بالضبط.
2. ضع client ID وsecret في .env وشغّل npm run oauth.
3. افتح http://localhost:4318 واختار الربط. وافق داخل راسل ميل ثم اعرض بيانات الصندوق.
4. جرّب إلغاء الربط. لو فشل الاتصال بخادم الإلغاء، يوضح المثال أنك تحتاج إلغاءه من التطبيقات.

قبل الاستخدام الإنتاجي#