YASend API

تطبيقات أمثلة

يضم مستودع YASend تطبيقين صغيرين كاملين في المجلد examples/. كل منهما:

  1. يرسل رمز تحقق عبر POST /v1/messages?async=true (مع Idempotency-Key وصلاحية 5 دقائق)؛
  2. يستقبل الويب هوك message.sent / message.failed ويتحقق من X-YASend-Signature-V2.
التطبيق التشغيل
examples/otp-node (Node.js 18+، بلا اعتماديات) YASEND_KEY=… YASEND_SESSION_ID=… WEBHOOK_SECRET=… node send-otp.mjs 963912345678
examples/otp-python (Python 3.10+، مع requests) YASEND_KEY=… YASEND_SESSION_ID=… python send_otp.py 963912345678

عيّن YASEND_API_URL لتوجيه أي من التطبيقين إلى خادم آخر.

يشغّل تطبيق Node أيضاً مستقبِل ويب هوك (--listen 8080) يطبع كل حدث تم التحقق منه. اجعله متاحاً من الإنترنت (عبر نفق مثلاً)، وسجّل رابطه بـ POST /v1/webhooks.

يُشغَّل المسار نفسه ضمن اختبارات YASend مع كل تغيير، فتبقى هذه الأمثلة صالحة للعمل.