ما هو عميل HTTP؟

يرسل عميل HTTP طلبات إلى خادم ويب أو API ويعرض الاستجابة الواردة. يستخدمه المطورون لتجربة endpoint قبل كتابة التعليمات البرمجية للتعامل معه، والتحقق من أن API يعيد الحالة والبيانات الصحيحتين، وإعادة إنتاج bug، أو معرفة الرؤوس التي يرسلها الخادم. تُعد تطبيقات سطح المكتب مثل Postman وInsomnia وYaak، وأداة سطر الأوامر curl، من أشهر الأمثلة.

وصف الأداة

هذه الأداة عميل HTTP خفيف يعمل في المتصفح، ولا تتطلب تثبيت أي شيء. اختر طريقة، وأدخل URL، وأضف معلمات الاستعلام والرؤوس والنص وبيانات الاعتماد، ثم اضغط على إرسال. تعرض الاستجابة رمز الحالة والوقت والحجم والرؤوس والنص، مع تنسيق JSON لتسهيل القراءة. يمكنك أيضًا لصق أمر curl لملء الطلب بالكامل، أو نسخ أي طلب كأمر curl.

الميزات

  • طلبات GET وPOST وPUT وPATCH وDELETE وHEAD وOPTIONS
  • إبقاء معلمات الاستعلام متزامنة مع URL، بحيث يمكنك تعديل أيٍّ منهما
  • رؤوس مخصصة، مع تحذير بشأن الرؤوس التي لن ترسلها المتصفحات
  • نصوص طلب بتنسيقات JSON وXML والنص العادي والنماذج المشفّرة بصيغة URL، مع ضبط Content-Type تلقائيًا
  • مصادقة Bearer token والمصادقة الأساسية
  • حالة الاستجابة ووقتها وحجمها ورؤوسها ونصها، مع تنسيق JSON بشكل واضح
  • عرض استجابات الصور كمعاينة، وإمكانية تنزيل أي استجابة كملف
  • استيراد طلب عن طريق لصق أمر curl، بما في ذلك خيار النسخ كـ cURL من أدوات مطوري المتصفح
  • تصدير الطلب الحالي كأمر curl

آلية العمل

ترسل الأداة طلبك باستخدام fetch API الخاص بالمتصفح، مباشرةً من جهازك إلى الخادم، ولذلك لا يمر أي شيء عبر خوادمنا. مع ذلك، تنطبق قواعد أمان المتصفح. لا يحصل الطلب المرسل إلى موقع ويب آخر على استجابة قابلة للقراءة إلا عندما يسمح ذلك الخادم بمرورها عبر CORS (مشاركة الموارد عبر المصادر المختلفة)، وهو ما تتيحه معظم واجهات API العامة ولا تتيحه العديد من الواجهات الخاصة. كما يرفض المتصفح السماح لصفحة ويب بتعيين بعض الرؤوس، مثل Cookie وHost وOrigin وUser-Agent، ولا يعرض سوى رؤوس الاستجابة التي يختار الخادم إتاحتها. ولا يمكن للصفحات المقدمة عبر https:// الاتصال بعناوين http:// العادية، باستثناء localhost في معظم المتصفحات.

نصائح

  • إذا فشل الطلب من دون استجابة، فافتح وحدة تحكم المطور في المتصفح؛ إذ توضح سبب المشكلة، والذي يكون عادةً غياب رأس Access-Control-Allow-Origin على الخادم.
  • لاختبار API الخاصة بك، اسمح بمصدر هذا الموقع في إعدادات CORS، أو اختبرها على localhost.
  • من الأفضل إرسال الطلب الذي يحتاج إلى cookies أو إلى عنوان IP لا يملكه إلا خادم باستخدام curl. انسخه من علامة تبويب cURL وشغّله في الطرفية.
  • اضغط على Enter في حقل URL لإرسال الطلب.
  • اترك المخطط فارغًا، وستضيف الأداة https://، أو http:// عند استخدام localhost و127.0.0.1.
  • بالنسبة إلى مفتاح API، أضفه كرأس، مثل X-Api-Key، في علامة تبويب الرؤوس.