مولّد استجابات حالة HTTP وهمية

كيفية استخدام مولّد استجابات حالة HTTP وهمية

اكتب رمز الحالة (مثل 404 أو 429).
اختر نمط الجسم، واسم المورد اختيارياً.
ولّد الاستجابة وانسخ استجابة HTTP الخام أو الجسم وحده.

مزايا مولّد استجابات حالة HTTP وهمية

أي رمز حالة من 100 إلى 599، مع أجسام وترويسات خاصة بكل حالة لنحو 40 رمزاً شائعاً
اختيار تلقائي للجسم: JSON لحالات النجاح، وproblem+json وفق RFC 9457 للأخطاء
متغيرات بصفحة خطأ HTML أو نص عادي أو من دون جسم
معالجة صحيحة لحالات 1xx و204 و304 (بلا جسم) ولترويسات Location في إعادة التوجيه
لوحة شرح: فئة الحالة ومعناها وإرشادات إعادة المحاولة وقابلية التخزين المؤقت

مثال على مولّد استجابات حالة HTTP وهمية

استجابة تحديد المعدّل (rate limit)

الإدخال:

النتيجة:

HTTP/1.1 429 Too Many Requests
Retry-After: 30
RateLimit-Limit: 100
RateLimit-Remaining: 0
Content-Type: application/problem+json

{ "type": "https://api.example.com/problems/too-many-requests", "title": "Too Many Requests", "status": 429, "detail": "Rate limit of 100 requests per minute exceeded. Retry in 30 seconds.", "retryAfter": 30 }

الأسئلة الشائعة حول مولّد استجابات حالة HTTP وهمية

ما رموز الحالة المدعومة؟

أي رمز من 100 إلى 599. ولنحو أربعين رمزاً شائعاً أجسام وترويسات غنية خاصة بكل حالة (Location لحالات 201/3xx، وRetry-After لحالتي 429/503، وWWW-Authenticate لحالة 401، وAllow لحالة 405)؛ أما الرموز الأخرى فتحصل على جسم عام.

ما صيغ الجسم التي يمكنني اختيارها؟

يختار الوضع التلقائي JSON لحالات النجاح وproblem+json وفق RFC 9457 للأخطاء؛ ويمكنك فرض JSON أو problem+json أو صفحة خطأ HTML أو نص عادي أو عدم وجود جسم على الإطلاق.

لماذا تكون استجابة 204 فارغة؟

يجب ألّا تحمل استجابات 204 و304 و1xx جسماً وفق RFC 9110؛ وتعكس الاستجابة الوهمية ذلك ليتعامل عميلك معها بشكل صحيح.

هل يمكنني اختبار كيفية تعامل عميلي مع الحالة؟

نعم — استخدم الاستجابة المولَّدة مع خادم محاكاة (stub)، أو استخدم محاكي رموز حالة API ضمن أدوات اختبار API للحصول على نقطة نهاية حيّة.