محاكي رموز حالة API

بمساعدة الخادم اختبار واجهات API

استخدم https://www.mutqansoft.sa/api/v1/simulate/<code> من تطبيقك أو اختباراتك لمحاكاة استجابات 4xx/5xx والاستجابات البطيئة والأجسام المخصّصة دون تغيير الخادم الخلفي لديك.

الخصوصية: ترسل هذه الأداة الطلب عبر خادم متقن للوصول إلى الهدف. يُنقل فقط العنوان والترويسات والمحتوى الذي تدخله، ولا يُحفظ أي شيء.

كيفية استخدام محاكي رموز حالة API

  1. أدخل رمز الحالة وتأخيراً اختيارياً وجسم JSON اختيارياً.
  2. اضغط «إنشاء عنوان URL» للحصول على نقطة النهاية وأمر cURL والمقتطفات.
  3. وجّه إعدادات تطبيقك أو المحاكاة (mock) أو اختبارك إلى عنوان URL.
  4. اضغط «جرّبه» لإرسال طلب من الصفحة والتأكد من الحالة والترويسات والجسم.

مزايا محاكي رموز حالة API

  • نقطة نهاية عامة تعيد أي حالة HTTP من 100 إلى 599 لكود العميل والاختبارات لديك
  • تأخير اختياري (حتى 30 ث) لمحاكاة الخدمات البطيئة أو التي تنتهي مهلتها
  • جسم JSON مخصّص عبر المعامل body؛ وجسم افتراضي مناسب في غير ذلك
  • دعم CORS مفعّل، وقبول أي طريقة؛ وتتضمن رموز 3xx ترويسة Location
  • أمر cURL ومقتطفات كود مع إجراء «جرّبه» يعرض الاستجابة الحيّة

مثال على محاكي رموز حالة API

محاكاة تحديد المعدّل

الإدخال:

Code 429 · Delay 1500 ms · Body { "error": "rate_limited", "retryAfter": 30 }

النتيجة:

https://www.mutqansoft.sa/api/v1/simulate/429?delay=1500&body=%7B%22error%22…
curl -i --max-time 7 'https://www.mutqansoft.sa/api/v1/simulate/429?…'
Live result: 429 Too Many Requests · 1.52 s · application/json

الأسئلة الشائعة حول محاكي رموز حالة API

كيف أستخدم نقطة النهاية؟

استدعِ https://www.mutqansoft.sa/api/v1/simulate/<code> بأي طريقة HTTP. أضف ?delay=<ms> لإبطاء الاستجابة (حتى 30 ث) و?body=<json> للتحكم في الجسم.

هل تدعم CORS؟

نعم — ترسل نقطة النهاية ترويسات CORS متساهلة حتى تتمكن تطبيقات المتصفح واختبارات الواجهة الأمامية من استدعائها مباشرةً.

هل توجد حدود للمعدّل؟

نعم، لكل عنوان IP، للحفاظ على توافر الخدمة للجميع. استخدم محاكاة محلية لاختبارات التحميل عالية الحجم.

هل يمكنني الحصول على حالة إعادة توجيه؟

نعم: تعيد رموز 3xx ترويسة Location تشير إلى المحاكي نفسه حتى يتمكن العملاء من اختبار معالجة إعادة التوجيه.

ملاحظات تقنية

يقدَّم المحاكي عبر Worker المنصة؛ فيعيد الحالة المطلوبة، ويلتزم بالتأخير ضمن حدّ المنصة، ويطبّق تحديد المعدّل لكل عنوان IP. أما رموز الحالة التي لا تحمل جسماً (1xx و204 و304) فتتجاهل الجسم المخصّص.