طريقة الاستخدام
- الصق أمر curl، أو حمّل المثال.
- اختر JavaScript fetch أو Node.js axios أو Python requests أو Go.
- انسخ الكود المُولَّد إلى مشروعك.
شرح الخيارات
- الخيارات المدعومة
- الخيارات المدعومة: -X، -H، -d / --data-raw / --data-binary / --data-urlencode، --json، -F، -u، -b، -A، -e، -G، -I، -L، -k، و--compressed، بالصيغة القصيرة أو الطويلة أو بصيغة --option=value. تُتجاهل الأعلام الخاصة بالناتج فقط مثل -s و-v و-o.
- أجسام JSON
- يُحوَّل الجسم المُرسَل بنوع محتوى JSON إلى كائن حرفي، مثل json=payload في Python، ليسهل تعديله.
- إعادة التوجيه
- لا يتبع curl إعادات التوجيه إلا إذا مررت -L. يحافظ الكود المُولَّد على هذا السلوك، مثل allow_redirects=False في Python.
مثال
هذا الأمر، كما نُسخ من المتصفح:
curl -X POST https://api.example.com/v1/users \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TOKEN' \
-d '{"name":"Ada","age":36}'
يصبح هكذا باستخدام fetch:
const response = await fetch("https://api.example.com/v1/users", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer TOKEN",
},
body: JSON.stringify({
"name": "Ada",
"age": 36
}),
redirect: 'manual',
});
وهكذا باستخدام Python requests:
response = requests.post("https://api.example.com/v1/users", headers=headers, json=payload, allow_redirects=False)
في Python يُترك الترويس Content-Type خارج headers لأن الوسيط json= يضبطه. ويحافظ كل من redirect: 'manual' وallow_redirects=False على السلوك الافتراضي لـ curl، وهو عدم اتباع إعادات التوجيه.
الأسئلة الشائعة
كيف أحصل على أمر curl من متصفحي؟
افتح أدوات المطوّرين، وانتقل إلى لوحة Network، وانقر بزر الماوس الأيمن على طلب واختر Copy → Copy as cURL. تُفهَم صيغتا bash وWindows cmd كلتاهما.
هل تُرسَل رموزي المميزة أو ملفات تعريف الارتباط إلى أي مكان؟
لا. يُحلَّل الأمر في متصفحك؛ ولا يُنفَّذ أو يُرفَع شيء. تذكّر إزالة الأسرار قبل مشاركة الكود المُولَّد.
لماذا يُبلَّغ عن خيار بأنه غير مدعوم؟
الخيارات التي تغيّر كيفية إجراء الطلب لكن ليس لها مكافئ بسيط، مثل شهادات العميل أو الوكلاء، لا تُحوَّل. أزلها وأضف الإعداد يدويًا.
الخصوصية
تعمل هذه الأداة بالكامل داخل متصفحك. تُعالَج ملفاتك ونصوصك على جهازك ولا تُرفع أبدًا إلى خوادمنا.