بيئة الاختبار
بيئة الاختبار هي الواجهة البرمجية الحقيقية وخلفها هاتف افتراضي. الطلبات المرسلة بمفتاح 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"}'import { SMSFabric } from '@smsfabric/sdk';
const sf = new SMSFabric({ apiKey: process.env.SMSFABRIC_TEST_KEY });
const [message] = await sf.messages.send({ to: '+201001234567', body: 'Sandbox test' });await new Promise((resolve) => setTimeout(resolve, 3000));const after = await sf.messages.get(message.id);console.log(after.provider, after.status); // sandbox deliveredimport osimport timeimport requests
headers = {"X-Api-Key": os.environ["SMSFABRIC_TEST_KEY"]}sent = requests.post( "https://api.smsfabric.com/v1/messages", headers=headers, json={"to": "+201001234567", "body": "Sandbox test"}, timeout=30,).json()["data"][0]time.sleep(3)after = requests.get(f"https://api.smsfabric.com/v1/messages/{sent['id']}", headers=headers, timeout=30).json()print(after["provider"], after["status"]) # sandbox delivered<?php$headers = ['X-Api-Key: ' . getenv('SMSFABRIC_TEST_KEY'), 'Content-Type: application/json'];$ch = curl_init('https://api.smsfabric.com/v1/messages');curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => json_encode(['to' => '+201001234567', 'body' => 'Sandbox test']), CURLOPT_HTTPHEADER => $headers, CURLOPT_RETURNTRANSFER => true,]);$sent = json_decode(curl_exec($ch), true)['data'][0];sleep(3);$ch = curl_init('https://api.smsfabric.com/v1/messages/' . $sent['id']);curl_setopt_array($ch, [CURLOPT_HTTPHEADER => $headers, CURLOPT_RETURNTRANSFER => true]);$after = json_decode(curl_exec($ch), true);echo $after['provider'] . ' ' . $after['status'] . "\n"; // sandbox deliveredتمر الرسالة بهذه الحالات خلال ثانيتين تقريبا:
| الوقت | الحالة | 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"، فتراها بجانب حركتك الحقيقية.
ما يمكنك اختباره
Section titled “ما يمكنك اختباره”- التحقق من الطلبات والتعامل مع الأخطاء ومنع التكرار.
- نقطة نهاية webhook والتحقق من التوقيع وإزالة التكرار.
- التعامل مع الحالات من
queuedإلىdelivered. - إنشاء الحملات وتقديرها وسرعتها وإيقافها مؤقتا واستئنافها وتقاريرها.
- القائمة السوداء ومعالجة STOP (أضف رقما إلى القائمة السوداء وأرسل إليه).
ما لا يمكنك اختباره في بيئة الاختبار: التسليم الحقيقي، وانقطاع هاتف أو فشله، والرسائل الواردة، وقبول رمز تحقق. استخدم لها مفتاحا حقيقيا وهاتفا مقترنا ورقمك الخاص.
عندما يعمل تكاملك في بيئة الاختبار، اتبع الانتقال إلى الإنتاج.