تخطَّ إلى المحتوى

بيئة الاختبار

بيئة الاختبار هي الواجهة البرمجية الحقيقية وخلفها هاتف افتراضي. الطلبات المرسلة بمفتاح sf_test_ يُتحقق منها وتُحفظ وتخضع لحدود المعدل وتُبلَّغ تماما مثل الطلبات الحقيقية، وتصلك webhooks نفسها، لكن لا تغادر أي رسالة أي شريحة. استخدمها للتطوير والتكامل المستمر والعروض.

الحصول على مفتاح اختبار

Section titled “الحصول على مفتاح اختبار”

في البوابة افتح المطوّرون ← مفاتيح API، واضغط إنشاء مفتاح API واختر تجريبي · بيئة اختبار في الوضع (شرح خطوة بخطوة). أو استدع POST /v1/api-keys وأنت مسجل الدخول مع "mode": "test". يبدأ المفتاح بـ sf_test_.

لا تحتاج إلى هاتف مقترن لاستخدام بيئة الاختبار.

ما يحدث لرسالة الاختبار

Section titled “ما يحدث لرسالة الاختبار”
نافذة طرفيّة
curl https://api.smsfabric.com/v1/messages \
-H "X-Api-Key: sf_test_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"to": "+201001234567", "body": "Sandbox test"}'

تمر الرسالة بهذه الحالات خلال ثانيتين تقريبا:

الوقت الحالة Webhook
0 ثانية queued message.queued
فورا routed مع provider: "sandbox" وdeviceId: null لا يوجد
نحو 0.5 ثانية sent message.sent
نحو ثانيتين delivered message.delivered

الوضع الحقيقي وبيئة الاختبار جنبا إلى جنب

Section titled “الوضع الحقيقي وبيئة الاختبار جنبا إلى جنب”
sf_live_ sf_test_
تصل الرسالة إلى المستلم نعم لا
يحتاج هاتفا مقترنا نعم لا
provider device sandbox
deviceId وsimId الهاتف والشريحة المستخدمان null
deviceId وsimId وpoolId في الطلب يجب أن تكون في مؤسستك تُتجاهل
نافذة الإرسال وscheduledAt تُطبقان كلتاهما تُطبق scheduledAt فقط
القائمة السوداء تُطبق (blocked) تُطبق (blocked)
التحقق من المدخلات ومنع التكرار وحدود المعدل تُطبق تُطبق
Webhooks تُرسل تُرسل
الحملات تعمل عبر هواتفك تعمل مع sandbox: true وتُسلَّم كلها
خدمة التحقق يُرسل الرمز عبر SMS تُنشأ العملية وتخضع للحدود كالمعتاد، لكن الرمز لا يُرسل أبدا

بيانات بيئة الاختبار والبيانات الحقيقية في المؤسسة نفسها. تظهر رسائل الاختبار في GET /v1/messages وفي شاشة الرسائل في البوابة مع provider: "sandbox"، فتراها بجانب حركتك الحقيقية.

  • التحقق من الطلبات والتعامل مع الأخطاء ومنع التكرار.
  • نقطة نهاية webhook والتحقق من التوقيع وإزالة التكرار.
  • التعامل مع الحالات من queued إلى delivered.
  • إنشاء الحملات وتقديرها وسرعتها وإيقافها مؤقتا واستئنافها وتقاريرها.
  • القائمة السوداء ومعالجة STOP (أضف رقما إلى القائمة السوداء وأرسل إليه).

ما لا يمكنك اختباره في بيئة الاختبار: التسليم الحقيقي، وانقطاع هاتف أو فشله، والرسائل الواردة، وقبول رمز تحقق. استخدم لها مفتاحا حقيقيا وهاتفا مقترنا ورقمك الخاص.

عندما يعمل تكاملك في بيئة الاختبار، اتبع الانتقال إلى الإنتاج.