CURL هو أداة سطر الأوامر التي تتيح إجراء طلبات HTTP لاختبار واجهات برمجة التطبيقات ويدعم مجموعة واسعة من الخيارات والبروتوكولات، مما يجعله أداة قوية لمهام مثل تنزيل الملفات، اختبار واجهات برمجة التطبيقات، وأداء مهام متعددة تتعلق بالشبكة. في هذا القسم، سنرى كيفية استخدام cURL لإرسال طلبات GET.
إذا كنت تريد معرفة المزيد عن cURL، يُنصح بقراءة هذه المقالة:
ما هو طلب HTTP GET؟
طلب GET هو أحد طرق HTTP المستخدمة من قبل شبكة الويب العالمية. إنه نوع من الطلبات التي يقدمها العميل (مثل متصفح الويب) إلى خادم ويب لاسترجاع أو الحصول على بيانات من مورد محدد. بعبارات أبسط، يتم استخدام طلب GET عندما تريد استرجاع معلومات من خادم.
عندما تدخل عنوان URL في متصفح الويب وتضغط على Enter، يقوم المتصفح عادةً بإرسال طلب GET إلى الخادم المحدد في عنوان URL. يطلب هذا الطلب من الخادم توفير المورد المطلوب، والذي يمكن أن يكون صفحة ويب، صورة، ملف، أو أي نوع آخر من البيانات.
إليك مثال أساسي على طلب GET باستخدام Curl:
curl -X GET https://api.example.com/resource
في هذا المثال:
curl: يستدعي أمر cURL.-X GET: يحدد أنه طلب GET (على الرغم من أنه اختياري حيث يقوم cURL بمفترض استخدام GET إذا لم يتم تحديده بشكل صريح).https://api.example.com/resource: هو عنوان URL للمورد الذي تطلبه.
كيفية إرسال طلبات GET باستخدام cURL
لإرسال طلب GET باستخدام cURL، يمكنك استخدام أمر curl في الطرفية أو موجه الأوامر لديك. إليك مثال أساسي:
curl https://www.example.com
هذه الأمر البسيط يرسل طلب GET إلى https://www.example.com ويطبع استجابة الخادم في الطرفية.
يمكنك أيضًا تضمين خيارات متنوعة ومعلمات إضافية مع أمر cURL. إليك بعض الأمثلة:
الخطوة 1. إضافة رؤوس:
curl -H "Authorization: Bearer YOUR_TOKEN" https://api.example.com/data
في هذا المثال، يتم استخدام خيار -H لتضمين رأس تفويض مع رمز نحاسي.
الخطوة 2. اتباع عمليات إعادة التوجيه:
curl -L https://www.example.com
يخبر خيار -L cURL بمتابعة عمليات إعادة التوجيه. إذا استجاب الخادم بإعادة توجيه (رمز الحالة HTTP 3xx)، سيقوم cURL تلقائيًا بطلب الموقع الجديد.
الخطوة 3. حفظ المخرجات إلى ملف:
curl -o output.html https://www.example.com
يتم استخدام خيار -o لحفظ المخرجات إلى ملف. في هذه الحالة، ستكون الاستجابة من الخادم محفوظة في ملف يسمى output.html.
الخطوة 4. تمرير معلمات الاستعلام:
curl "https://api.example.com/data?param1=value1¶m2=value2"
يمكنك تضمين معلمات الاستعلام في عنوان URL لإرسال معلومات إضافية إلى الخادم. يساعد هذا في التحقق من أن API تعيد رمز الحالة الصحيح مثل 200 OK.
Apidog: طريقة بصرية لإرسال طلب GET
على الرغم من أن cURL أداة مفتوحة المصدر، قد يكون من الصعب استخدامها دفعة واحدة للمطورين غير المألوفين باستدعاءات سطر الأوامر. لكن لا تقلق، تقديم واجهة أكثر بديهية يمكن أيضًا أن يساعدك بسرعة على التعلم، وهو استخدام Apidog.
يسهل Apidog عمليات واجهة برمجة التطبيقات باستخدام أدوات الاختبار، التصحيح، التصميم، والمحاكاة، والتوثيق. تعزز واجهته سهلة الاستخدام التعاون، مما يحسن اختبار واجهة برمجة التطبيقات ويسهل إنشاء مخططات JSON/XML.
من الجدير بالذكر أن Apidog يتفوق في الوثائق الاستجابة API القابلة للتخصيص والجذابة بصريًا وأدوات الاختبار سهلة الاستخدام مع التأكيدات وسلاسل الاختبار.
الدليل حول كيفية إرسال طلبات GET في Apidog
- سجل أو قم بتنزيل: قم بتنزيل منصة Apidog لنظامي التشغيل Windows أو Mac أو Linux.
2. استيراد أوامر cURL: قم بالوصول إلى نافذة استيراد Apidog. الصق أوامر cURL في مربع النص للتكامل السلس. ثم استخدم أي أداة لالتقاط الحزمة.
3. تكوين معلمات الطلب: انتقل إلى جسم واجهة برمجة التطبيقات. قم بتعيين تكرار رؤوس واجهة برمجة التطبيقات، الجسم، والإعدادات الأخرى.
4. اختبار وتنقيح: أرسل واجهة برمجة التطبيقات لتلقي استجابة. راجع السجلات، تحليل مقاييس الأداء، وتحسين استدعاءات واجهة برمجة التطبيقات التلقائية للحصول على موثوقية وكفاءة.
الخلاصة
بالنسبة للمبتدئين، يُنصح باستخدام أداة Apidog المستندة إلى واجهة المستخدم، حيث توفر واجهة بديهية لإجراء طلبات واجهة برمجة التطبيقات بسهولة. يتوافق Apidog مع cURL، مما يسمح بالاستيراد والتصدير السلس للأوامر.
بينما Apidog مستخدم وسهل، يوفر cURL وظائف أغنى. للحصول على أفضل النتائج، يُقترح استخدام الأداتين معًا: Apidog من أجل البساطة وcURL من أجل الميزات المتقدمة.