ماذا تفعل هذه الأداة
يحوّل محول curl إلى كود أمر curl إلى كود جاهز للتشغيل لسبعة أهداف: JavaScript fetch وNode.js axios وPython requests وGo net/http وPHP cURL وJava HttpClient وC# HttpClient. كثيرًا ما تقدّم وثائق واجهات البرمجة وPostman وأدوات المطور في المتصفح الطلبات على شكل أوامر curl، وتوفّر عليك هذه الأداة إعادة كتابة الطريقة والعنوان والترويسات والمحتوى والمصادقة يدويًا.
كُتب المحلل خصيصًا لسطر أوامر curl. فهو يقرأ علامات الاقتباس كما يفعل bash، ويفهم الخيارات القصيرة المجمّعة مثل -sSL والقيم الملتصقة مثل -XPOST، ويحافظ على ترتيب الترويسات.
طريقة الاستخدام
- الصق أمر curl في خانة الإدخال، أو اضغط مثال لتجربة أحدها.
- اختر اللغة التي تريدها.
- انسخ النتيجة أو نزّلها كملف شيفرة مصدرية.
يصبح المحتوى المرسل بـ -d محتوى مرمّزًا كنموذج، ويصبح --json (أو Content-Type من نوع JSON) محتوى JSON منسّقًا حيث تسمح اللغة، وتتحول حقول -F إلى نموذج multipart مع رفع الملفات. يتحول -u user:password إلى خيار المصادقة الأساسية الخاص بكل لغة، وتقابل -k و-L و-m و-x التحقق من TLS وإعادة التوجيه ومهلة الانتظار والوكيل.
مثال
يرسل هذا الأمر بيانات JSON مع رمز bearer:
curl https://api.example.com/v1/users \
-H 'Authorization: Bearer TOKEN' \
--json '{"name":"Ada"}'في Python يصبح استدعاء requests.post() مع قاموس headers وjson=json_data، وفي Go يصبح http.NewRequest يضبط الترويسات واحدة تلو الأخرى ويمرر المحتوى عبر قارئ نصوص.
نصائح
- إذا أبلغ المحول عن خطأ، فإن الرسالة تشرح المشكلة ويقفز المؤشر إلى الجزء المسبب لها، مثل خيار غير معروف أو علامة اقتباس غير مغلقة.
- تُتجاهل الأنابيب وعمليات إعادة التوجيه بعد الأمر (
| jq .و> out.json). - يقرأ الكود المُنشأ الملفات المشار إليها بـ
@fileوقت التشغيل، لذا احرص على صحة هذه المسارات بالنسبة إلى مكان تشغيل البرنامج. - راجع البيانات السرية قبل مشاركة رابط: يضع زر المشاركة الأمر في جزء # من الرابط.
الأسئلة الشائعة
› هل يُرسَل أمر curl الخاص بي إلى خادم؟
لا. يُحلَّل الأمر ويُحوَّل بالكامل داخل متصفحك، لذا لا تغادر الرموز وملفات تعريف الارتباط وكلمات المرور الموجودة فيه جهازك أبدًا.
› ما خيارات curl المدعومة؟
الخيارات التي تحدد الطلب: -X و-H و-d و--data-raw و--data-binary و--data-urlencode و--json و-F و-u و-b و-A و-e و-G و-I و-L و-k و-m و-x و--compressed و--url. أما الخيارات التي تؤثر في مخرجات curl نفسه فقط، مثل -s و-v و-o و-w، فتُقبل وتُتجاهل.
› هل يمكنني لصق أمر منسوخ من أدوات المطور في المتصفح؟
نعم. استخدم «نسخ بصيغة cURL (bash)» في لوحة الشبكة. يفهم المحول متابعة الأسطر بـ \ و^ (Windows cmd) و` (PowerShell)، وكذلك علامات الاقتباس المفردة والمزدوجة و$'…'.
› ماذا يحدث للخيارات التي لا يستطيع الكود إعادة إنتاجها؟
يبدأ الكود المُنشأ بتعليق Note، مثلًا عندما لا يمكن التعبير عن -k باستخدام fetch أو عندما يقرأ curl ملفًا لا يفتحه الكود. أما الخيارات غير المعروفة فيُبلَّغ عنها بخطأ يشير إلى الخيار نفسه بدقة.