أداة سطر الأوامر curl أصبحت راسخة للمطورين ومديري النظام على حد سواء. إن تنوعها في نقل البيانات عبر بروتوكولات متعددة معروف جيدًا. لكن curl تقدم ميزة قوية وغالبًا ما لا يتم الاستفادة منها: القدرة على استكشاف خيارات الاتصال المتاحة على الخادم. هذه الوظيفة، التي تتم من خلال طلبات HTTP OPTIONS وخيارات سطر الأوامر في curl، تمكّن المستخدمين من فهم أعمق لكيفية تعامل الخادم مع الطلبات وما الإجراءات التي يسمح بها على موارد معينة.
إذا لم يكن لديك خلفية في PHP، فلا تقلق - Apidog، منصة تطوير API متكاملة تقدم ميزات توليد الأكواد للمطورين. ابدأ في إنشاء كود PHP لواجهة عميلك في بضع نقرات!
للتعرف على المزيد حول ما يمكن أن تقدمه Apidog، انقر على الزر أدناه!
في الأقسام التالية، سنتعمق في تفاصيل إرسال طلبات HTTP OPTIONS باستخدام curl، مستعرضين الخيارات المتاحة وكيف تقدم رؤى قيمة حول قدرات الخادم. سنستعرض أيضًا أمثلة عملية توضح كيفية الاستفادة من هذا النهج للتواصل الفعال مع الخادم.
ما هو cURL؟
cURL هو اختصار لـ "client URL" ويعتبر مشروع برمجي يتكون من جزئين رئيسيين:
- أداة سطر الأوامر cURL: هذا هو البرنامج الذي تقوم بتشغيله في الطرفية الخاصة بك لنقل البيانات. يعمل مع بروتوكولات متعددة، وأشهرها HTTP (نقل الويب) و HTTPS (نقل الويب الآمن).
- مكتبة libcurl للتطوير: توفر هذه المكتبة الوظائف الأساسية لنقل البيانات. يمكن للمبرمجين دمجها في تطبيقاتهم للاستفادة من ميزات cURL.
وظائف cURL المفيدة
يدعم العديد من البروتوكولات
لا يقتصر cURL على HTTP. يمكنه التعامل مع FTP (نقل الملفات)، SFTP (نقل الملفات الآمن)، SMTP (البريد الإلكتروني)، وأكثر من ذلك، مما يجعله أداة متعددة الاستخدامات للتفاعل مع خوادم مختلفة.
سطر أوامر قوي
يوفر أمر curl تحكمًا دقيقًا. يمكنك تحديد الخيارات للمصادقة، والرؤوس، وتنسيق البيانات، والإبلاغ عن التقدم، والمزيد.
يعمل في كل مكان
يعمل cURL على تقريبًا أي نظام تشغيل، بما في ذلك Windows و macOS و Linux وحتى الأنظمة المدمجة. مما يجعله أداة قابلة للاستخدام على نطاق واسع.
الاختبار والأتمتة
يتفوق cURL في اختبار كيفية تواصل الخوادم وأتمتة نقل البيانات. يمكنك برمجة تفاعلات معقدة باستخدام cURL.
ما هي طلبات OPTIONS؟
طلبات OPTIONS هي نوع خاص من طلبات HTTP المستخدمة لاكتشاف ما هي الإجراءات وتنسيقات البيانات التي يسمح بها الخادم لمورد معين. تخيل طلب OPTIONS كزر "تحقق من الخيارات" في موقع ويب. لا يقوم بتنفيذ أي إجراءات بنفسه، لكنه يخبرك بما يمكنك القيام به.
تفصيل طلبات OPTIONS
الوظيفة
تسترجع طلبات OPTIONS معلومات حول الطرق المسموح بها (إجراءات مثل GET و POST، إلخ) وتنسيقات البيانات المدعومة (الرؤوس) التي يقبلها الخادم لمورد معين.
العملية
عند إرسال طلب OPTIONS، فإنه يتضمن طريقة "OPTIONS" في خط الطلب. يستجيب الخادم برمز الحالة ويشرح الإجراءات وتنسيقات البيانات المسموح بها.
حالات الاستخدام
- CORS (مشاركة الموارد عبر origem): في الحالات التي تحاول فيها صفحة ويب من دومين واحد الوصول إلى موارد في دومين آخر، تعمل طلبات OPTIONS كاختبار مسبق. يستخدم الخادم ذلك لمعرفة ما إذا كان سيسمح بالطلب الفعلي (مثل GET أو POST) قبل أن يرسله العميل.
- استكشاف API: يمكن للمطورين استخدام طلبات OPTIONS لاستكشاف وفهم قدرات API قبل بناء تطبيقات تتفاعل معها.
أمثلة على كود طلبات cURL OPTIONS
إليك ثلاث أمثلة على كود طلبات cURL HEAD التي يمكنك الرجوع إليها إذا لزم الأمر.
مثال 1 - التحقق من الخيارات لموقع ويب
هذا المثال يسترجع الطرق المسموح بها والرؤوس المدعومة لصفحة البداية لـ ويكيبيديا.
curl -X OPTIONS https://en.wikipedia.org/wiki/Main_Page
مثال 2 - استكشاف قدرات API
هذا المثال يتحقق من الخيارات لنقطة النهاية /tasks.
curl -X OPTIONS https://api.example.com/tasks
مثال 3 - اختبار مسبق لطلب عبر منشأ مختلف
افترض أن صفحة ويب على domainA.com ترغب في الوصول إلى بيانات من API على domainB.com. هذا المثال يحاكي طلب OPTIONS للتحقق مما إذا كان CORS يسمح بالطلب الفعلي.
curl -X OPTIONS -H "Origin: https://domainA.com" https://api.domainB.com/data
تفسير الكود:
-X OPTIONS: يحدد هذه الطريقة HTTP كخيارات.
-H Origin: https://domainA.com: يتم تضمين هذا الرأس في اختبار CORS المسبق، مما يشير إلى منشأ الطلب.
ستتضمن الاستجابة من هذه الأوامر رمز حالة HTTP (مثل 200 للنجاح) ورؤوسًا تفصيلية عن الطرق المدعومة والرؤوس المدعومة للمورد المحدد.
Apidog - العمل مع أي نوع من APIs
Apidog هي أداة شاملة لتطوير API توفر الوظائف للمطورين لاستيراد مجموعة متنوعة من APIs - بما في ذلك أوامر cURL!
دعنا نرى كيف يمكنك استيراد cURL بسهولة إلى Apidog!
استيراد APIs cURL في ثوانٍ مع Apidog
يدعم Apidog المستخدمين الذين يرغبون في استيراد أوامر cURL إلى Apidog. في مشروع فارغ، انقر على الزر البنفسجي + الموجود في الجزء العلوي الأيسر من نافذة Apidog، واختر استيراد cURL.
انسخ والصق أمر cURL في المربع المعروض على شاشتك.
إذا تم بنجاح، ينبغي أن تكون الآن قادرًا على عرض أمر cURL في شكل طلب API.
توليد كود PHP على الفور مع Apidog
إذا لم يكن لديك تجربة سابقة في البرمجة بلغة PHP، فلا تخف! يوفر Apidog ميزة توليد الأكواد التي يمكنك الاعتماد عليها، ويقدم لك أطر كود للعديد من لغات البرمجة الأخرى.
أولاً، ابحث عن زر </> توليد كود في أي API أو طلب، واختر توليد كود عميل من القائمة المنسدلة.
بعد ذلك، اختر PHP، وابحث عن قسم cURL. يجب أن ترى الآن الكود الناتج لـ cURL. كل ما عليك هو نسخه ولصقه في بيئة تطويرك المتكاملة (IDE) والاستمرار في تطوير تطبيقك.
الخاتمة
تساعد قدرة cURL على إرسال طلبات OPTIONS في تقديم أداة قيمة لأي شخص يتفاعل مع الخوادم. سواء كنت مطورًا يستكشف API أو مدير نظام يبحث في مشكلات الاتصال، فإن فهم ما تكشفه طلبات OPTIONS يمكّنك من اتخاذ قرارات مستنيرة.
من خلال الاستفادة من هذه الوظيفة، يمكنك التأكد من أن تطبيقاتك تتفاعل مع الخوادم بأمان وفعالية. تذكر، أن تنوع cURL يمتد إلى ما هو أبعد من طلبات OPTIONS فقط. بفضل خيارات سطر الأوامر الواسعة، يتيح cURL التحكم الدقيق في نقل البيانات، مما يجعله أداة قوية لمهام الويب المختلفة.