قبل استخدام واجهة سطر الأوامر، قم بالمصادقة باستخدام مفتاح واجهة برمجة التطبيقات الخاص بك:
dodo login
سيقوم ما يلي:
فتح متصفحك على صفحة مفاتيح واجهة برمجة التطبيقات في Dodo Payments
مطالبتك بإدخال مفتاح واجهة برمجة التطبيقات
طلب اختيار البيئة (وضع الاختبار أو الوضع الفعلي)
تخزين بيانات اعتمادك محليًا في ~/.dodopayments/api-key
يدعم CLI تخزين مفتاح واجهة برمجة تطبيقات واحد لكل بيئة. إذا تم تكوين مفاتيح وضع الاختبار والوضع الفعلي معًا، فسيُطلب منك اختيار البيئة التي تريد استخدامها للجلسة الحالية.
تتضمن واجهة سطر الأوامر أداتين قويتين لاختبار الويب هوك أثناء التطوير: المستمع الذي يعيد توجيه الويب هوك الخاصة بالاختبار المباشر إلى خادمك المحلي، والمشغّل الذي يرسل بيانات وهمية لأي نقطة نهاية.
إعادة توجيه الويب هوك من Dodo Payments مباشرة إلى خادم التطوير المحلي في الوقت الفعلي.
dodo wh listen
1
Enter your local endpoint URL
قدّم عنوان URL المحلي الذي ترغب في استلام الويب هوك عليه (على سبيل المثال، http://localhost:3000/webhook).
2
Automatic setup
يقوم CLI بإنشاء نقطة نهاية للويب هوك على حساب Dodo Payments تلقائيًا إذا لم تكن موجودة بالفعل، ثم يفتح اتصال WebSocket لتلقي الأحداث في الوقت الفعلي.
3
Receive and forward
عند حدوث حدث ويب هوك (من دفعة اختبار، تغيير اشتراك، إلخ)، يتلقاه CLI، ويسجل نوع الحدث، ويعيد توجيه الطلب الكامل مع رؤوسه ومحتواه إلى نقطة النهاية المحلية الخاصة بك. يتم تسجيل الاستجابة من نقطة النهاية الخاصة بك وإرسالها مرة أخرى.
يعمل مستمع الويب هوك فقط مع مفتاح واجهة برمجة تطبيقات لوضع الاختبار. تأكد من تسجيل الدخول باستخدام مفتاح وضع الاختبار قبل استخدام dodo wh listen.
يحتفظ المستمع بالرؤوس الأصلية للويب هوك (webhook-id, webhook-signature, webhook-timestamp) عند إعادة التوجيه إلى نقطة النهاية المحلية الخاصة بك، حتى تتمكن من اختبار منطق التحقق من التوقيع.
أرسل حمولة ويب هوك وهمية إلى أي نقطة نهاية لإجراء اختبار سريع دون الحاجة إلى إنشاء معاملات حقيقية.
dodo wh trigger
هذا الدليل يأخذك عبر:
تحديد عنوان نقطة النهاية الوجهة
اختيارياً تكوين معرف العمل، معرف المنتج، والبيانات الوصفية
اختيار حدث محدد لتفعيله من قائمة تفاعلية
إرسال الحمولة الوهمية وعرض الاستجابة
بعد كل حدث، يمكنك اختيار حدث آخر لتفعيله أو الخروج — مما يجعل من السهل اختبار عدة معالجات أحداث في جلسة واحدة.
ترسل أداة المشغّل حمولات وهمية بدون توقيعات ويب هوك. قم بإيقاف تشغيل التحقق من توقيعات الويب هوك أثناء الاختبار باستخدام unsafe_unwrap() بدلًا من unwrap() في معالج الويب هوك الخاص بك.
