استدعاء واجهات برمجة التطبيقات SOAP باستخدام cURLs (مع صورة)

عبارة "SOAP cURLs" تتكون من تكنولوجيتين شائعتين قد تكون قد سمعت بهما من قبل. قبل كل شيء، تتناول هذه المقالة التكنولوجيات وقدراتها.

💡

Apidog، منصة تطوير تركز على تصميم واجهات البرمجة (API)، تقدم لمستخدميها العديد من التعديلات والمواصفات لدورة حياة واجهة برمجة التطبيقات بالكامل.

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

المصطلحات الأساسية حول SOAP و cURLs

تشير المصطلحات "SOAP" و "cURL" كل منها إلى تكنولوجيا فريدة.

SOAP: SOAP (بروتوكول الوصول إلى الكائنات البسيط) هو بروتوكول رسائل يستخدم أساسًا لتبادل المعلومات الهيكلية بين تطبيقين أو نظامين.

يلعب دورًا مهمًا في صناعة خدمات الويب بسبب قدرته على تسهيل تبادل البيانات والتواصل بين مكونات البرمجيات المختلفة.

SOAP هو بروتوكول منظم للغاية يستخدم تنسيق XML، ويستخدم بشكل رئيسي لتطبيقات المؤسسات أو الأنظمة القديمة. ومع ذلك، قد تكون لاحظت أن بروتوكولات أخرى أصبحت أكثر شيوعًا، مثل أسلوب REST المعماري الذي يتم مناقشته بكثرة.

تأتي خدمات الويب SOAP عادة في شكل ملفات WSDL.
cURL: cURL هو اختصار لـ "عميل URL". cURL هو برنامج مجاني ومفتوح المصدر يوفر وظيفتين رئيسيتين، أداة سطر الأوامر curl ومكتبة libcurl.

تتيح أداة سطر الأوامر curl نقل البيانات باستخدام بروتوكولات الشبكة المختلفة مثل HTTP و HTTPS وغيرها مباشرة من طرفيتك. هناك العديد من الاستخدامات لـ cURL. على سبيل المثال، يمكنك تنزيل الملفات، إرسال البيانات، واسترجاع محتوى صفحة ويب أو استجابة خادم.

من ناحية أخرى، تعمل المكتبة libcurl كوظيفة أساسية لنقل البيانات. يمكن دمج libcurl في لغات برمجة شعبية مختلفة، مثل C و C++ و Python و PHP. مع libcurl، يمكن للمطورين الاستفادة من أداء cURL في تطبيقات لأداء مهام مثل أتمتة تنزيل ورفع الملفات، بالإضافة إلى بناء أدوات أو تطبيقات مخصصة للتفاعل مع خدمات الويب.

عندما يتم دمج المصطلحات، تشير "SOAP cURLs" إلى استخدام وظائف cURL للتفاعل بشكل محدد مع خدمات الويب المعتمدة على SOAP.

تفصيل كيفية عمل SOAP cURLs

1. تعريف رسالة SOAP:

أولاً، مطلوب رسالة طلب SOAP محددة. يتضمن ذلك تحديد العملية التي ترغب في استدعائها على خدمة الويب والبيانات التي ترغب في إرسالها، كل ذلك بتنسيق XML.
يمكنك العثور على أدوات وموارد متنوعة متاحة لمساعدتك في تعريف رسالة SOAP، مثل ملف WSDL (لغة وصف خدمات الويب) المقدمة من خدمة الويب أو أدوات عبر الإنترنت لتوليد رسائل SOAP.

2. بناء أمر cURL:

بعد ذلك، قم ببناء أمر cURL الذي يحدد تفاصيل طلب HTTP الذي يحمل رسالة SOAP. يتضمن ذلك استخدام خيارات cURL المختلفة لتحديد:
URL: عنوان نقطة النهاية لخدمة الويب التي تريد الوصول إليها.
الطريقة: عادة ما يتم تعيين طريقة HTTP على "POST" حيث يتم إرسال رسائل SOAP عادة باستخدام طريقة POST.
الرؤوس: رؤوس معينة لتواصل SOAP، مثل "Content-Type: text/xml; charset=utf-8" مطلوبة لتحديد تنسيق الرسالة وترميز الحروف.
البيانات: سيتم تضمين محتوى رسالة SOAP الفعلي في جسم الطلب باستخدام خيار "-d" مع سلسلة الرسالة أو ملف يحتوي على الرسالة.

3. إرسال الطلب واستلام استجابة:

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

4. المعالجة التالية للإجابة:

يمكنك تحليل استجابة XML لاستخراج المعلومات ذات صلة التي أعادت الصفحة الويب. قد يتطلب ذلك استخدام أدوات أو مكتبات حسب لغة البرمجة المستخدمة.

كيفية استدعاء SOAP API باستخدام cURL

الخطوة 1: أولاً، ستحتاج إلى إعداد رسالة SOAP الخاصة بك. إذا كانت هذه هي المرة الأولى التي تقوم فيها بإنشاء رسالة SOAP، يمكنك الرجوع إلى نموذج الكود أدناه - ومع ذلك، ستحتاج إلى تعديله لضمان تلبيته لاحتياجاتك.

نموذج رسالة SOAP:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://www.example.com/webservice">
   <soapenv:Header/>
   <soapenv:Body>
      <ws:getGreeting>
         <ws:name>جون دو</ws:name>
      </ws:getGreeting>
   </soapenv:Body>
</soapenv:Envelope>

هل يمكنك تخمين ما الذي تطلبه الرسالة من خدمة الويب؟

الخطوة 2: قم بإعداد أمر cURL الخاص بك في واجهة الأوامر. مماثلة للخطوة أعلاه، يمكنك إلقاء نظرة على نموذج الكود.

نموذج أمر cURL:

curl -X POST \
-H "Content-Type: text/xml; charset=utf-8" \
-H "SOAPAction: http://www.example.com/webservice/getGreeting" \
-d @soap_request.xml "https://dummy.webservice.com/path/to/service"

تفسير أمر cURL:

-X POST: يحدد طريقة طلب HTTP على أنها POST.
-H "Content-Type: text/xml; charset=utf-8" تحدد رأس نوع المحتوى بالإشارة إلى بيانات XML بتشفير UTF-8.
-H "SOAPAction: http://www.example.com/webservice/getGreeting" تحدد رأس SOAPAction من خلال تحديد العملية المستهدفة.
-d @soap_request.xml تقرأ محتوى رسالة SOAP من ملف يسمى "soap_request.xml".
"https://dummy.webservice.com/path/to/service" يتم استبداله بعنوان URL الفعلي لنقطة نهاية خدمة الويب.

تطبيقات الحياة الواقعية لـ SOAP cURLs

1. تكامل الأنظمة القديمة: غالبًا ما كان يتم استخدام SOAP في تطبيقات المؤسسة القديمة. إذا كنت بحاجة للتفاعل مع مثل هذه الأنظمة القديمة التي لم تتم ترقيتها إلى بروتوكولات أحدث، يمكن لـ cURL تقديم وسيلة لصياغة يدويًا وإرسال طلبات SOAP لتبادل البيانات.

2. اختبار وتصحيح خدمات الويب SOAP: يمكن للمطورين استخدام cURL لإرسال طلبات SOAP محددة مباشرة وتحليل الاستجابات لحل المشكلات المتعلقة بخدمات الويب SOAP. يسمح ذلك بتحكم دقيق على الطلب ويساعد على عزل المشكلات المحتملة.

3. سكربتات مخصصة وأتمتة: يمكن دمج cURL في سكربتات وبرامج لأتمتة المهام المتعلقة بتواصل SOAP. يمكن أن يكون ذلك مفيدًا في سيناريوهات مثل جلب البيانات من خدمة SOAP بشكل دوري أو تفعيل إجراءات معينة بناءً على رسائل SOAP المستلمة.

Apidog - يجعل اختبار SOAP أسهل

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

api design apidog test build — وظائف Apidog التي يمكن للمستخدمين الاستفادة منها

زر

يدعم Apidog استيراد ملفات WSDL بحيث يمكنك عرض خدمات الويب المعتمدة على SOAP. من ناحية أخرى، يمكنك أيضًا توليد أوامر cURL باستخدام توليد كود لغة العميل لـ Apidog، حتى لا تضطر إلى التخمين ما إذا كنت صحيحًا أم خاطئًا!

استيراد ملفات WSDL لعرض خدمات الويب المعتمدة على SOAP على Apidog

import wsdl file apidog — استيراد ملف WSDL إلى Apidog

أولاً، اضغط على زر الإعدادات الموجود على الجانب الأيسر من شريط الأدوات العمودي. ثم، ابحث عن استيراد البيانات تحت قسم إدارة البيانات. أخيرًا، اختر WSDL لاستيراد ملفات WSDL إلى Apidog.

تعديل ملفات WSDL على Apidog

edit wsdl file apidog — تعديل ملف WSDL باستخدام Apidog

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

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

استيراد cURL إلى Apidog

يدعم Apidog استيراد أكواد سطر أوامر cURL لأولئك الذين لديهم ذلك جاهزًا.

start curl import apidog — بدء عملية استيراد cURL على Apidog

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

paste curl command apidog — قم بلصق أمر cURL الخاص بك في الحقل الفارغ

هنا، يمكنك لصق أمر cURL الخاص بك. بمجرد أن تفعل، اضغط Enter على لوحة المفاتيح أو زر موافق لعرض أمر cURL الخاص بك.

curl code body edit apidog — قرر إذا كنت بحاجة إلى تعديل أي شيء آخر

إذا كانت العملية ناجحة، يمكنك عرض أمر cURL كجزء من جسم JSON، كما هو موضح في الصورة أعلاه. هنا، يمكنك القيام بالتعديلات أو التغييرات، متى وأينما لزم الأمر.

توليد كود أمر cURL باستخدام Apidog

curl comannd code generation apidog — توليد كود سطر أوامر cURL

لبدء توليد كود cURL، ابحث واضغط على زر </> الموجود في الزاوية العليا اليمنى من نافذة Apidog. ثم، اختر توليد كود العميل.

curl code generate apidog — اختر كود سطر أوامر cURL باستخدام Apidog

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

الخاتمة

SOAP cURLs هما تكنولوجيتان يمكن أن تعملان جنبًا إلى جنب، حيث يمكن استخدام أوامر cURL لتواصل خدمات الويب المعتمدة على SOAP. ومع ذلك، يجب مراعاة أن استخدامهما في تناقص بسبب الأساليب المعمارية الأكثر شعبية مثل REST.

Apidog هو منصة تطوير واجهة برمجة التطبيقات الشاملة التي تعزز التطوير القائم على التصميم لواجهات البرمجة. مع Apidog، يمكنك بسهولة تعديل وتصميم واجهات البرمجة بصريًا بفضل واجهته البسيطة والبديهية. علاوة على ذلك، فهي خيار قوي لأي مطورين مهتمين بتجربة منصة جديدة حيث يدعم Apidog استيراد أنواع ملفات مختلفة، بما في ذلك Postman و WSDL والعديد من الملفات الأخرى.