محوّل cURL إلى شيفرة
حوّل أمر curl إلى شيفرة JavaScript باستخدام fetch أو Axios، أو إلى شيفرة Python باستخدام Requests، مع الحفاظ على الطريقة والترويسات وملفات تعريف الارتباط والمصادقة ومحتوى الطلب. تعمل في متصفحك.
الإدخال
الإخراج
ملف القراءة
ما الذي تفعله الأداة؟
تحوّل أداة تحويل cURL إلى شيفرة أمر curl إلى شيفرة ترسل طلب HTTP نفسه من برنامجك. وتُنتج ثلاثة أنواع من الشيفرات:
- JavaScript (fetch): واجهة fetch المضمّنة في المتصفحات وDeno وBun وNode.js.
- Node.js (Axios): مكتبة Axios الشائعة، مع وحدات Node.js للملفات وإعدادات TLS.
- Python (Requests): مكتبة Requests.
من الطرق الشائعة للحصول على أمر استخدام أدوات المطوّرين في المتصفح: في لوحة الشبكة، انقر بزر الفأرة الأيمن على طلب واختر «نسخ كـ cURL». وغالبًا ما تعرض وثائق API أمثلتها بصيغة أوامر curl أيضًا.
كيفية الاستخدام
- ألصق أمر curl. يمكن أن تمتد الأوامر الطويلة على عدة أسطر، مع وضع شرطة مائلة عكسية في نهاية كل سطر، كما تتوقع shell.
- اختر اللغة.
- انسخ الشيفرة أو نزّلها كملف (
request.mjsلـ JavaScript، وrequest.pyلـ Python).
تتحدّث الشيفرة أثناء الكتابة. وإذا احتوى الأمر على خطأ يمنع curl من تنفيذه، مثل علامة اقتباس غير مغلقة أو خيار غير معروف، فستشير الأداة إليه بدلًا من ذلك.
ما الذي يتم تحويله؟
- الطريقة، بما في ذلك الطرق التي يحددها curl تلقائيًا: الخيار
-dوالخيار-Fيجعلان الطريقة POST، والخيار-Iيجعلها HEAD، والخيار-Tيجعلها PUT. - عنوان URL، بما في ذلك أي استعلام يضيفه الخيار
-Gأو--url-query. - الترويسات من
-H، ووكيل المستخدم من-A، والمُحيل من-e، وcookies من-b، والتي تصبح قاموسcookiesفي Python. - المصادقة الأساسية من
-uأو من عنوان URL، باستخدام الطريقة الخاصة بكل مكتبة لإرسالها، ورموز Bearer من--oauth2-bearer. كما يتضمن Python مصادقة Digest. - محتوى الطلب: يتحول JSON الناتج من
--jsonأو من تعيين نوع المحتوى إلى JSON إلى كائن أو قاموس، وتتحول بيانات النماذج الناتجة من-dإلىURLSearchParamsأو قاموس، وتتحول النماذج متعددة الأجزاء الناتجة من-FإلىFormDataأو قاموسfiles، مع تضمين الملفات المرفوعة. - المهلة من
--max-time(و--connect-timeoutفي Python)، والخيار-kلتخطي عمليات التحقق من TLS، وشهادات CA وشهادات العميل، والوكيل من-x.
تُستبعد الترويسات التي يضيفها curl بنفسه، مثل User-Agent الخاص به وAccept: */* وContent-Length، لأن المكتبات ترسل ترويساتها الخاصة. كما تُستبعد الخيارات التي لا تغيّر سوى طريقة عرض curl للاستجابة، مثل -s أو -v.
عندما يتعذّر تحويل شيء ما
لا يوجد لبعض العناصر ما يعادلها في مكتبة أو لغة. وتُضاف هذه العناصر كتعليقات في أعلى الشيفرة، حتى لا يُسقط أي شيء دون تنبيه:
- تُدرج الخيارات التي لا مقابل لها، مثل
--retry، ضمن «لم يتم تحويله». - لا يمكن لـ fetch تخطي عمليات التحقق من TLS أو استخدام وكيل أو تعيين مهلة اتصال، كما لا تسمح المتصفحات للنصوص البرمجية بتعيين ترويسة Cookie، على عكس Node.js.
- تُقرأ الملفات التي يقرأها curl، مثل
-d @data.jsonأو-F photo=@cat.jpg، من القرص في Node.js وPython. أما في JavaScript للمتصفح، فتظهر كقيمة مؤقتة عليك استبدالها، مثل ملف من عنصر<input type="file">. - عندما يرسل الأمر عدة طلبات، تكون الشيفرة للطلب الأول.
أمثلة
- يتحول
curl https://example.com/إلىrequests.get("https://example.com/")في Python. - يتحول
curl -u ada:secret https://api.example.com/meإلىauth=("ada", "secret")في Python وإلى خيارauthفي Axios. - يتحول
curl --json '{"item": "sourdough loaf"}' https://api.example.com/ordersإلىjson={"item": "sourdough loaf"}في Python وإلىJSON.stringify({ item: "sourdough loaf" })مع fetch.
آلية العمل
تُقرأ الأوامر بالطريقة التي تقرؤها بها shell وcurl، مع علامات الاقتباس ومحارف الهروب ومتابعة الأسطر، باستخدام المحلّل نفسه الذي يستخدمه مدقّق أوامر cURL في الموقع. ثم يُحوّل الطلب الذي كان curl سيرسله إلى شيفرة. تجري جميع العمليات في متصفحك، لذا لا تغادر الأوامر التي تتضمن رموزًا أو كلمات مرور جهازك.
الميزات
- JavaScript fetch وNode.js Axios وPython Requests
- الترويسات وcookies ومصادقة Basic وBearer
- محتوى JSON والنماذج والنماذج متعددة الأجزاء والملفات
- المهلات وخيارات TLS والشهادات والوكلاء
- تعليقات لكل ما يتعذّر تحويله
- رسائل واضحة عند وجود أخطاء في الأمر
- نسخ الشيفرة أو تنزيلها
- تعمل في متصفحك