الانتقال إلى المحتوى الرئيسي
تُجري الـ sandbox keys (sk_sandbox_) مكالمات حقيقيّة، لكن ضمن ضوابط مُصمَّمة للاختبار الآمن.

​
نافذة التجربة

يبدأ مؤقّت تجربة الـ sandbox عند أوّل API call لك ويستمرّ 30 دقيقة. بعد انتهائه، تُعيد طلبات الـ callback ‏403 مع error_code: SANDBOX_EXPIRED. وتعرض لوحة التحكّم عدًّا تنازليًّا مباشرًا.

​
قفل الوجهة

منعًا لإساءة الاستخدام، لا يمكن لمكالمات الـ sandbox أن ترِنّ إلّا على رقم هاتف التسجيل الخاصّ بمالك المؤسّسة — وهو الرقم الذي جرى التحقّق منه عند التسجيل. أمّا الـ callback إلى أيّ to آخر فيُعيد 403 مع error_code: SANDBOX_DESTINATION_NOT_ALLOWED. ويتطلّب الاتصال بوجهات اعتباطيّة الترقية إلى الإنتاج (قريبًا).

​
أرقام الاختبار والأخطاء المحاكاة

افرض نتائج محدّدة دون الاعتماد على مكالمة حيّة، بطريقتين. ويغلب الـ header إن انطبق الاثنان معًا. رقم اختبار محجوز
الرقمالنتيجة
+966500000017محاكاة server_error
الـ x-wave-simulate header اضبط x-wave-simulate على POST /v1/callback لفرض متغيّر خطأ (الـ sandbox keys فقط — يتجاهله الإنتاج):
القيمةالمُحاكاة
rate_limitرفض بسبب تجاوز حدّ المعدّل
invalid_queueطابور غير معروف
queue_unavailableالطابور غير متاح مؤقّتًا
server_errorعطل في الـ upstream/الشبكة الهاتفيّة
invalid_numberوجهة غير صالحة
curl -X POST https://api.wave.sa/v1/callback \
  -H "Authorization: Bearer sk_sandbox_xxxxxxxxxxxx" \
  -H "X-Wave-Simulate: server_error" \
  -H "Content-Type: application/json" \
  -d '{ "to": "+966500000000" }'

​
الحدود

تخضع الـ sandbox keys لحدود المعدّل — راجع حدود المعدّل.