منشئ طلبات API

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

أنشئ الطلبات بصرياً، وأرسلها عبر مُرحِّل (relay) آمن أو مباشرةً من المتصفح عندما تسمح سياسة CORS بذلك، واطّلع على الحالة والتوقيت والترويسات والجسم المنسّق، ثم صدّر الطلب بصيغة cURL أو كود برمجي. لا تُخزَّن الترويسات الحساسة أبداً.

الخصوصية: تتم المعالجة في متصفحك حيثما أمكن. تُمرَّر فحوصات الشبكة عبر خادم متقن ولا تُحفظ.

كيفية استخدام منشئ طلبات API

  1. اختر الطريقة وأدخل عنوان URL (يمكن إضافة معاملات الاستعلام في تبويب «المعاملات» (Params)).
  2. أضف الترويسات، أو اختر نوع المصادقة، أو الصق جسم JSON في تبويب «الجسم» (Body).
  3. اضغط «إرسال». تظهر الاستجابة مع الحالة والوقت والحجم والجسم المنسّق والترويسات.
  4. افتح لوحة «التصدير» لنسخ الطلب بصيغة cURL أو كود برمجي لمجموعة اختباراتك.
  5. فعّل خيار «طلب مباشر من المتصفح» (Direct browser request) في الإعدادات عند استدعاء خادم محلي يسمح بـ CORS.

مزايا منشئ طلبات API

  • الطريقة وعنوان URL ومعاملات الاستعلام والترويسات والجسم والمصادقة (Bearer وBasic ومفتاح API) في محرّر طلبات بتبويبات
  • يرسل افتراضياً عبر مُرحِّل يتجاوز قيود CORS، أو مباشرةً من المتصفح لواجهات localhost والشبكات الداخلية
  • لوحة استجابة مع شارة الحالة والتوقيت والحجم وعرض الجسم بصيغة منسّقة/خام/شجرية وجدول ترويسات قابل للترتيب
  • تصدير الطلب بصيغة cURL أو fetch أو axios أو Python أو Java أو C# أو Go أو PHP أو Ruby أو HTTP خام
  • منسّق لجسم JSON، وحفظ الطلب عبر تحديث الصفحة، والإرسال بالضغط على Ctrl/⌘+Enter
  • لا تُخزَّن الترويسات الحساسة وبيانات الاعتماد أبداً

مثال على منشئ طلبات API

إرسال طلب POST لطلبية إلى نقطة نهاية اختبارية

الإدخال:

POST https://httpbin.org/anything/orders
Content-Type: application/json

{ "customer": "cust_1029", "items": [{ "sku": "ABC-1234", "qty": 2 }] }

النتيجة:

200 OK · 412 ms · 1.1 KB · application/json
{
  "json": { "customer": "cust_1029", "items": [ { "sku": "ABC-1234", "qty": 2 } ] },
  "method": "POST",
  …
}

الأسئلة الشائعة حول منشئ طلبات API

هل يمرّ طلبي عبر خوادم متقن؟

افتراضياً نعم: يُرسل الطلب عبر مُرحِّل حتى لا تعيقه قيود CORS، ولا يخزّن المُرحِّل طلبك أو استجابتك أبداً. فعّل خيار «طلب مباشر من المتصفح» في الإعدادات لاستدعاء نقطة النهاية مباشرةً من متصفحك — وهو مفيد لواجهات localhost والشبكات الداخلية التي تسمح بـ CORS.

هل تُحفظ رموزي أو كلمات مروري؟

لا. تُحفظ قيم المصادقة والترويسات الحساسة (Authorization وCookie ومفاتيح API) في الذاكرة فقط طوال بقاء الصفحة الحالية. أما عنوان URL والمعاملات والجسم فتُحفظ في جلسة متصفحك حتى لا يضيع عملك عند تحديث الصفحة.

لماذا أحصل على خطأ شبكة عند استخدام http://localhost؟

يرفض المُرحِّل العناوين الخاصة وعناوين الاسترجاع (loopback) والعناوين المحلية للرابط (link-local) لأسباب أمنية. فعّل خيار «طلب مباشر من المتصفح» — يستطيع متصفحك الوصول إلى localhost ما دام الخادم المحلي يرسل ترويسات CORS.

هل يمكنني تصدير الطلب إلى كود؟

نعم. بعد الإرسال، تقدّم لوحة التصدير cURL (bash وPowerShell وcmd) وfetch/axios في JavaScript وPython وJava وC# وGo وPHP وRuby وHTTP خام.

هل يوجد حدّ للحجم؟

تُرحَّل أجسام الطلبات حتى 1 ميغابايت؛ أما الاستجابات الأكبر فيقتطعها المُرحِّل ويشير إلى ذلك.

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

تمرّر نقطة نهاية المُرحِّل الطريقة والترويسات والجسم كما هي بالضبط، وتتبع عمليات إعادة التوجيه عند طلب ذلك، وتعيد الحالة والترويسات والجسم (حتى حدّ المُرحِّل) والحجم والتوقيت (الزمن الإجمالي وزمن الوصول إلى أول بايت). وتُرفض العناوين الخاصة وعناوين الاسترجاع والعناوين المحلية للرابط عمداً.

في الوضع المباشر تُستخدم واجهة fetch في المتصفح؛ ويجب أن يستجيب الهدف لطلب CORS التمهيدي (preflight) عند استخدام ترويسات مخصّصة. وتقتصر ترويسات الاستجابة المرئية لـ JavaScript على ما يحدّده الهدف في Access-Control-Expose-Headers.