محوّل cURL

ما هو محوّل cURL؟

محوّل cURL يحوّل أمر curl - وهو الصيغة التي يستخدمها كل توثيق API وكل تصدير من Postman وكل مساعد ذكاء اصطناعي - إلى كود جاهز للصق في لغة البرمجة التي تعمل بها فعليًا. الترويسات، وسلاسل الاستعلام، وأجسام JSON، وملفات multipart، والمصادقة الأساسية، وملفات الكوكيز كلها تُنقل تلقائيًا، فلا حاجة لترجمة الطلب يدويًا.

صيغة curl هي الطريقة العالمية لوصف طلب HTTP، لكنك نادرًا ما *تشغّل* curl في الإنتاج. أنت تشغّل JavaScript fetch، أو Python requests، أو حزمة net/http في Go، أو ما تستخدمه منصّتك. هذه الأداة تسدّ تلك الفجوة: ألصق curl، انقر على التبويب، انسخ الكود.

كل شيء يعمل محليًا داخل متصفحك. أمر curl وترويساتك وتوكناتك لا تغادر جهازك أبدًا - وهذا مفيد عند لصق أوامر تحتوي على توكنات Bearer حقيقية أو ملفات كوكيز جلسة.

ما الذي ستتعلّمه أثناء التحويل

• أعلام curl تُترجم إلى مفاهيم محدّدة في كل عميل HTTP: -H ترويسة طلب، و-d جسم، و-X طريقة الطلب، و-u مصادقة أساسية، و-F حقل نموذج multipart.
• إذا وجد curl جسمًا (-d أو --data أو -F) ولم يجد -X، فإنه يعتمد POST افتراضيًا - وهذا نفس السلوك الافتراضي لمعظم العملاء، لذا فإن غياب -X يبقى POST في الإخراج.
• أجسام JSON تختلف عن أجسام النماذج. Content-Type: application/json يعني أن الجسم يُرسل حرفيًا، أمّا application/x-www-form-urlencoded فيعني أن أزواج المفتاح/القيمة تُجمع بـ &.
• العلم -G يرفع الجسم إلى سلسلة الاستعلام في طلبات GET. يظهر ذلك في الإخراج - سترى params / query مملوءة ولا جسم مرسلًا.

كيف تحوّل curl إلى كود خطوة بخطوة

1. 1

   ألصق أمر curl

   ضع الأمر كاملًا - بما في ذلك علامات \ لاستكمال الأسطر المنسوخة من التوثيق - في مربّع الإدخال. المحلّل ينظّف علامات الاقتباس الذكية وعلامات موجّه PowerShell تلقائيًا.

2. 2

   اختر اللغة المستهدفة

   تغطّي التبويبات JavaScript fetch وTypeScript وNode axios وPython requests وPython httpx وGo وPHP وRuby وJava HttpClient وC# HttpClient وHTTPie وPowerShell. التبديل بين التبويبات مجاني - التحليل يعمل مرة واحدة فقط.

3. 3

   افحص الطلب بعد التحليل

   افتح لوحة *الطلب بعد التحليل* للتأكّد أن الطريقة، والـ URL، والترويسات، ونوع الجسم، والخيارات مثل insecure أو follow redirects انتقلت كما توقّعت.

4. 4

   انسخ وعدّل المصادقة

   انسخ الكود المُولّد إلى مشروعك. إذا تضمّن curl توكن Bearer أو كوكيز، استبدل القيمة الحرفية بمتغيّر بيئة قبل عمل commit.

مرجع سريع لأعلام cURL

الأعلام التي يفهمها هذا المحوّل وما تُترجم إليه في الكود المُولّد.

أمثلة على تحويل cURL

curl 'https://api.example.com/v1/lessons?limit=20&track=python' \  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.demo'

const response = await fetch('https://api.example.com/v1/lessons?limit=20&track=python', {  method: 'GET',  headers: {    'Authorization': 'Bearer eyJhbGciOiJIUzI1NiJ9.demo'  }});const data = await response.json();

curl 'https://api.example.com/v1/users' \  -H 'Content-Type: application/json' \  --data-raw '{"name":"Ada","age":36}'

import requests
headers = {    'Content-Type': 'application/json',}json_data = {"name":"Ada","age":36}
response = requests.post('https://api.example.com/v1/users', headers=headers, json=json_data)response.raise_for_status()

curl 'https://api.example.com/upload' \  -F 'caption=Hello' \  -F 'photo=@./avatar.jpg'

import requests
files = {    'caption': (None, 'Hello'),    'photo': open('./avatar.jpg', 'rb'),}
response = requests.post('https://api.example.com/upload', files=files)response.raise_for_status()

curl 'https://api.example.com/me' \  -u alice:s3cret \  -b 'session=2f9a; theme=dark'

const response = await fetch('https://api.example.com/me', {  method: 'GET',  headers: {    'Authorization': 'Basic YWxpY2U6czNjcmV0',    'Cookie': 'session=2f9a; theme=dark'  }});

أخطاء شائعة عند تحويل curl

• لصق curl يحتوي على علامات اقتباس ذكية (', ', ", ") منسوخة من تدوينة - تبدو كأنّها علامات اقتباس لكنها تكسر تحليل الشِل. المحوّل ينظّفها، لكن انسخ الأمر الأصلي قدر الإمكان.
• ترك العلم -k (--insecure) في الإنتاج. هذا يعطّل التحقق من شهادات TLS - ولا بأس في التطوير المحلي، لكنه خطر في حركة المرور الحقيقية.
• نسيان أن --data-raw و--data يختلفان في السلوك - --data يُرمّز المدخل بـ URL encoding. استخدم --data-raw لأجسام JSON التي تحتوي على @ أو &.
• لصق أمر curl.exe من ويندوز دون تحويل علامات ^ لاستكمال السطر إلى \. المحوّل يعالج هذا، لكن المحلّل صارم في علامات الاقتباس - تأكّد من حدود النصوص.
• نسخ توكنات Bearer أو الكوكيز إلى نظام التحكم بالإصدارات بعد التحويل. حوّلها إلى متغيّرات بيئة (process.env.API_TOKEN أو os.environ['API_TOKEN']) قبل عمل commit.

أسئلة شائعة حول محوّل cURL