مُنشئ أمر cURL — اصنع طلبات واجهة برمجة تطبيقات معقدة دون تذكر الأعلام

تُعرفون كورل. استخدمتموه آلاف المرات. ولكن كلما أردتم إرسال طلب POST مع بطاقة Bearer، وجسم JSON، ورأس مخصص، تنتهي في البحث عن "الإجابة" مئة مرة. الأعلام ليست صعبة — بل هناك الكثير منها.curl send json bodyالإجابة ليست صعبة — بل هناك الكثير منها.

لماذا يظل كورل الأداة المفضلة لاختبار واجهات برمجة التطبيقات؟

كورل متاح في كل مكان — لينكس، ماك أو إس، ويندوز، وعوامل دوكر، ومحركات التحقق التلقائي. لا يحتاج إلى واجهة رسومية، أو ملحق، أو حساب. عندما تضعون أمر كورل في سطر الأوامر، يعمل. هذا هو السبب في أن كورل يظل لغة موحدة لاختبار واجهات برمجة التطبيقات: يُشار إلى كورل في سلاك، ويُنسخ من الوثائق، ويُستخدم في سجلات الأوامر دون تفكير إضافي.

المشكلة ليست كورل نفسه — بل هي نمط الأعلام. يشعر الأعلام بالانسجام. -X POST يُحدد الطريقة. -H يضيف رأسًا، ولكن تحتاج إلى علامة واحدة لكل رأس. -d يُرسل جسمًا، ولكن فقط إذا تذكروا ذلك -d يُغير الطريقة تلقائيًا إلى POST. -u user:pass يُعالج التحقق الأساسي، ولكن بطاقة Bearer توضع في رأس. -F مخصصة لرفع ملفات. -k تُتجاهل التحقق من التشفير. بعد فترة، لا تختبر واجهة برمجة التطبيقات — بل تُحلل أمر كورل.

مُقدّم أمر كورل المرئي

ال مُقدّم أمر كورل على iotools.cloud يُتيح لك واجهة مرئية لتكوين أوامر كورل دون تذكر الأعلام. املأ الحقول، وينتج لك الأداة أمرًا جاهزًا للنسخ والتشغيل.

هناك ما يغطيه:

• طريقة HTTP – GET، POST، PUT، PATCH، DELETE — خيار واحد، لا حاجة -X مطلوبة.
• مواقع URL ومواصفات الاستعلام – أضف المعلمات بشكل فردي؛ يُحول المُدخلات تلقائيًا إلى صيغة URL ويُضيفها بشكل صحيح.
• أوامر الرؤوس – أضف كمّا -H رؤوسًا كما تحتاج، مرة واحدة في كل مرة. لا حاجة للإغلاق اليدوي.
• المصادقة – انتقل بين "لا شيء"، "التحقق الأساسي"، و"بطاقة Bearer". يُدخل الأداة العلامة أو الرأس المناسب تلقائيًا.
• جسم الطلب – الصق بيانات JSON أو بيانات النموذج أو النص البسيط. يختار الأداة نوع المحتوى والعلامة المناسبة.
• معاينة الأمر – يُحدث أمر كورل النهائي تلقائيًا عند الكتابة. نقرة واحدة تنسخه إلى مساحة الذاكرة.

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

أمثلة واقعية على أوامر كورل

1. اختبار واجهة برمجة تطبيقات عامة

يُستخدم JSONPlaceholder كواجهة برمجة تطبيقات عامة مجانًا من قبل المطورين للاختبار والنمذجة. إليك كيفية استرجاع مقالة واحدة:

curl -X GET "https://jsonplaceholder.typicode.com/posts/1"   -H "Accept: application/json"

في مُقدّم أمر كورل: قم بتحديد الطريقة إلى GET، أدخل الموقع، أضف رأسًا (Accept: application/json). تُولد المعاينة أمرًا أعلاه. لا حاجة للإغلاق، لا حاجة للبحث عن العلامة.

2. إرسال طلب POST مع جسم JSON ورمز Bearer

هذا هو المزيج الذي يبحث عنه المطورون بشكل متكرر. أنشئ مقالة جديدة على JSONPlaceholder مع رمز تحقق:

curl -X POST "https://jsonplaceholder.typicode.com/posts"   -H "Content-Type: application/json"   -H "Authorization: Bearer YOUR_TOKEN_HERE"   -d '{"title":"Test Post","body":"Hello from curl","userId":1}'

في المُقدّم: الطريقة = POST، الموقع مملوء، حقل رمز Bearer يحصل على رمزك (يكتب المُقدّم رأسًا تلقائيًا)، يحصل الحقل على البيانات JSON. تُظهر المعاينة الأمر المذكور أعلاه. نسخ. انسخ. مكتمل. Authorization: Bearer 3. رفع ملف متعدد المكونات

3. تحميل ملف متعدد الأجزاء

تتطلب رفع الملفات -F بدلاً من -d، ويخلطها المطورون بشكل متكرر. يتعامل مُقدّم "بيانات النموذج" معها بشكل صحيح:

curl -X POST "https://api.example.com/upload"   -H "Authorization: Bearer YOUR_TOKEN_HERE"   -F "file=@/path/to/file.pdf"   -F "description=My document"

4. طلب باستخدام التحقق الأساسي

اختبار نقطة نهاية تستخدم التحقق الأساسي:

curl -X GET "https://api.example.com/protected"   -u "username:password"   -H "Accept: application/json"

اختر "التحقق الأساسي" في قائمة التحقق في المُقدّم، أدخل بياناتك — يتعامل المُقدّم مع -u العلامة بحيث لا تُدخل بياناتك يدويًا.

استخدام أوامر كورل المُولدة خارج سطر الأوامر

أوامر كورل يمكنك نسخها يمكن استخدامها مجددًا. إليك أين تُصبح أوامر كورل مفيدة خارج الاختبارات الفردية:

• مُراقبة خطوط التصنيع – أدخل أمر كورل إلى خطوة في سلسلة GitHub Actions أو مُراقبة GitLab. التحقق من صحة النظام، تفعيلات ويب، إشعارات التسليم — يتعامل كورل مع كل ذلك دون إضافة اعتمادات SDK إلى خطتك.
• أوامر سطر الأوامر – اجعل الأمر داخل دالة، واستبدل المتغيرات بـ $VAR، وتحصل على مُستخدم واجهة برمجة تطبيقات جاهز في عشرة أسطر من باش.
• وثائق API – أوامر كورل هي صيغة وثائق عالمية. انسخ أمرًا مُولّدًا إلى وصفك، أو صفحة نوتيون، أو وثيقة كونفيلانس. يمكن لأي مُستخدم تشغيلها فورًا بغض النظر عن لغته أو مكونه.
• مشاركة مع زملائك – أمر كورل واحد في رسالة سلاك أسرع من "أدخل بستمان، استورد المجموعة، قم بتكوين متغير البيئة".

أدوات مُرافق لعملية تطوير واجهة برمجة تطبيقات كاملة

إذا كنت تبني عملية تطوير أو تكامل شاملة لواجهات برمجة التطبيقات، فإن أدوات مُرافقتين تُستخدمان جيدًا مع مُقدّم أمر كورل:

• منشئ ترويسة طلب HTTP – أنشئ وتحقق من الرؤوس قبل نسخها إلى أمر كورل. مفيد عند العمل مع مجموعات رؤوس معقدة مثل طلبات التحقق المسبق للـ CORS أو أنظمة التحقق المخصصة.
• مولد توقيع واجهة برمجة التطبيقات – بعض الواجهات (مثل واجهات AWS، ويب هوكات Stripe) تتطلب طلبات موقعة بـ HMAC. أنشئ التوقيع الصحيح وانسخه إلى أمر كورل دون الحاجة إلى تحميل SDK كامل.

ابدأ في التصميم

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

قد يعجبك أيضاً