كيفية استخدام cURL لاختبار واجهة برمجة التطبيقات REST (أفضل طريقتين)

لقد تم تدريبك على بيانات حتى أكتوبر 2023.

الطريقة 1. CURL لاختبار WebSocket مع Apidog

cURL هي أداة سطر أوامر لإرسال طلبات HTTP، بينما يوفر Apidog واجهة رسومية لتبسيط اختبار WebSockets. يقوم Apidog بإلغاء الحاجة لتكوين أوامر cURL يدويًا، مما يسهل إنشاء الرسائل وحفظها وإرسالها إلى نقاط نهاية WebSocket. تتيح واجهته البديهية لكل من المبتدئين والمطورين المتمرسين تصحيح WebSockets بكفاءة أكبر.

يمكنك إنشاء طلب WebSocket، وتعيين الرسائل والمعلمات، وحفظ الطلب، والاتصال بخدمة WebSocket، وإرسال طلبات WebSocket. هذا النهج يلغي تعقيدات أوامر cURL اليدوية، مما يجعل اختبار WebSocket أكثر سهولة.

الخطوة 1. يمكنك إنشاء واجهة برمجة تطبيقات WebSocket بالنقر على زر “+” بجانب شريط البحث.

خيار واجهة برمجة تطبيقات WebSocket الجديدة (بيتا) موجود في قائمة المنسدلة. انقر فوقه، ويمكنك إدخال عنوان URL لواجهة برمجة تطبيقات WebSocket الخاصة بك لإنشاء اتصال وإرسال/استقبال الرسائل.

الخطوة 2. الآن، في قسم الرسالة، يمكنك إضافة المعلومات التي تحتاج إلى إرسالها إلى الخادم، وسيقوم الخادم بالتقاط هذه المعلومات في نهايته.

الخطوة 3. يمكنك تعيين المعلمات وفقًا لمتطلباتك. يمكنك تعيين أنواع بياناتك إلى سلسلة، ints، مصفوفات، إلخ.

الخطوة 4. بعد تنفيذ طلبك، يمكنك حفظه للاستخدام في المستقبل. يتيح ذلك الوصول السهل إلى الطلب.

الخطوة 5. يمكنك الآن الاتصال وإرسال طلبات WebSocket لإنشاء اتصال WebSocket. يمكنك القيام بذلك بالنقر على زر الاتصال بجوار شريط البحث. عند الانتهاء بنجاح من الاتصال، سترى رسالة نجاح.

الخطوة 5. يمكنك الآن التواصل مع الخادم باستخدام WebSocket الذي أنشأته للتو. يمكنك إرسال رسائلك ومعلماتك إلى الخادم بالنقر على زر الإرسال.

يمكنك أيضًا التواصل مع العميل بعد إنشاء الاتصال بنجاح.

أتمتة واجهة برمجة التطبيقات باستخدام cURL في Apidog

تنطوي أتمتة واجهة برمجة التطبيقات باستخدام cURL في Apidog على الاستفادة من قدرات أوامر cURL ضمن منصة Apidog. يساعد ذلك في تبسيط وأتمتة اختبار واجهة برمجة التطبيقات والتفاعلات. الدليل خطوة بخطوة لتحقيق أتمتة واجهة برمجة التطبيقات موضح أدناه. تحتاج الآن إلى استيراد أوامر cURL في Apidog.

قم بالوصول إلى نافذة الاستيراد في Apidog والصق أوامر cURL في مربع النص المقدم. يتيح ذلك دمج أوامر cURL بسلاسة في منصة Apidog. يمكنك استخدام أي أداة لتسجيل الحزم لذلك.

بعد ذلك، تحتاج إلى تكوين إعدادات الأتمتة الخاصة بك. تحتاج إلى الانتقال إلى صفحة الإعدادات. يمكنك تعيين تردد استدعاءات واجهة برمجة التطبيقات المؤتمتة وإجراء معالجة الأخطاء هناك.

استخدم أدوات اختبار Apidog لاختبار وتحسين سير العمل الآلي لواجهة برمجة التطبيقات بنشاط. يمكنك مراجعة السجلات، وتحليل مقاييس الأداء، وإجراء التعديلات لتحسين استدعاءات واجهة برمجة التطبيقات الآلية من حيث الموثوقية والكفاءة.

الطريقة 2. اختبار واجهات برمجة التطبيقات REST باستخدام أوامر cURL

طريقة بسيطة أخرى لاختبار واجهة برمجة تطبيقات REST هي من خلال أوامر cURL في وحدة التحكم الخاصة بك. cURL هي أداة سطر أوامر تتيح إجراء طلبات HTTP لاختبار واجهات برمجة التطبيقات. في هذا القسم، سنرى كيفية استخدام cURL لاختبار بعض سيناريوهات واجهة برمجة التطبيقات الشائعة.

اختبار طلب GET

لاختبار استرجاع مورد من واجهة برمجة التطبيقات، يمكننا إجراء طلب GET باستخدام curl. على سبيل المثال:

cURL https://myapi.com/users/1 

سيقوم هذا بإجراء طلب GET إلى نقطة النهاية /users/1 وعرض الاستجابة الخام.

يمكننا أيضًا تمرير العلامة -i لتضمين رؤوس الاستجابة:

cURL -i https://myapi.com/users/1

يساعد ذلك في التحقق من أن واجهة برمجة التطبيقات ترجع رمز الحالة الصحيح مثل 200 OK.

اختبار طلب POST

لاختبار إنشاء مورد، نحتاج إلى إجراء طلب POST. على سبيل المثال، لإنشاء مستخدم جديد:

cURL -X POST -H "Content-Type: application/json" -d '{"name":"John", "email":"john@example.com"}' https://myapi.com/users

هنا نستخدم -X POST لإجراء طلب POST، و-H لتعيين رأس Content-Type، و-d لتمرير حمولة JSON.

ينبغي أن ترجع واجهة برمجة التطبيقات حالة 201 تم إنشاؤها في حال النجاح.

اختبار PUT و PATCH

لاختبار تحديث مورد، يمكنك إجراء طلبات PUT أو PATCH تمامًا كما تفعل مع POST.

على سبيل المثال، لتحديث بريد إلكتروني لمستخدم باستخدام طلب PUT:

cURL -X PUT -H "Content-Type: application/json" -d '{"email":"john@newdomain.com"}' https://myapi.com/users/1

و PATCH لتحديث بريد إلكتروني لمستخدم جزئيًا:

cURL -X PATCH -H "Content-Type: application/json" -d '{"email":"john@newdomain.com"}' https://myapi.com/users/1

اختبار DELETE

لاختبار حذف مورد، قم بإجراء طلب DELETE:

cURL -X DELETE https://myapi.com/users/1

يجب أن ترجع واجهة برمجة التطبيقات استجابة 204 لا محتوى عند النجاح.

الخاتمة

يوفر cURL طريقة سريعة وسهلة لاختبار نقاط نهاية واجهة برمجة تطبيقات REST. يمكنك بسهولة إجراء أنواع مختلفة من الطلبات وفحص الاستجابات. عند تطوير واجهة برمجة تطبيقات جديدة، جرب استخدام cURL للتحقق مما إذا كانت تتعامل مع عمليات CRUD كما هو متوقع قبل الدمج مع الواجهة الأمامية.