cURL Builder — ابزار بصری ساخت ریکوئست‌های HTTP

در سازنده cURL، تب احراز هویت را انتخاب کرده و توکن Bearer را انتخاب کنید. توکن خود را وارد کنید و سازنده دستور curl -H "Authorization: Bearer YOUR_TOKEN" URL را تولید می‌کند. در curl خام، از فلگ -H استفاده کنید: curl -H "Authorization: Bearer abc123" https://api.example.com. برای تبدیل این به کد، دستور را در مبدل curl جایگذاری کنید — هدر مجوز صحیح را برای Python، JavaScript و بیش از 30 زبان دیگر تولید خواهد کرد.

از فلگ -u استفاده کنید: curl -u username:password https://api.example.com. این یک هدر Authorization: Basic رمزگذاری‌شده با Base64 ارسال می‌کند. در سازنده cURL، گزینه احراز هویت → Basic را انتخاب کرده و فیلدهای نام کاربری و رمز عبور را پر کنید. احراز هویت Basic به خودی خود رمزنگاری نشده است — همیشه از HTTPS استفاده کنید. curl2code فلگ -u را به مکانیزم احراز هویت معادل در هر زبان مقصد به درستی تبدیل می‌کند.

اکثر APIها کلیدها را در یک هدر می‌پذیرند: curl -H "X-API-Key: YOUR_KEY" https://api.example.com. برخی APIها از Authorization: ApiKey KEY یا پارامتر کوئری استفاده می‌کنند. در سازنده cURL، از تب هدرها برای افزودن هر هدر سفارشی یا از تب احراز هویت برای پشتیبانی داخلی از کلید API استفاده کنید. سازنده سینتکس صحیح curl را تولید می‌کند که سپس می‌توانید آن را به Python، Go یا هر زبان دیگری تبدیل کنید.

یک درخواست GET ساده فقط curl https://api.example.com است — GET متد پیش‌فرض است. برای افزودن هدرها، از -H استفاده کنید: curl -H "Accept: application/json" -H "Authorization: Bearer token" https://api.example.com/users. در سازنده cURL، URL را وارد کنید، متد را روی GET نگه دارید و هدرهای خود را در تب هدرها اضافه کنید. دستور تولیدشده را می‌توان با مبدل به کد تبدیل کرد.

هر دو داده‌ها را به سرور ارسال می‌کنند، اما از نظر معنا متفاوت هستند. POST یک منبع جدید ایجاد می‌کند: curl -X POST -d {"name":"Alice"} URL. PUT یک منبع موجود را به طور کامل جایگزین می‌کند: curl -X PUT -d {"name":"Bob"} URL. از PATCH برای به‌روزرسانی‌های جزئی استفاده کنید. در عمل، سینتکس curl یکسان است به جز فلگ -X. سازنده cURL به شما امکان می‌دهد متدها را از یک منوی کشویی تغییر دهید — بقیه درخواست بدون تغییر می‌ماند.

از -X POST همراه با -H و -d استفاده کنید: curl -X POST -H "Content-Type: application/json" -d {"key":"value"} https://api.example.com. در سازنده cURL، متد را روی POST تنظیم کنید، به تب بدنه بروید، JSON را انتخاب کنید و داده‌های خود را جایگذاری کنید — هدر Content-Type به صورت خودکار اضافه می‌شود. این رایج‌ترین الگوی درخواست API است. آن را با مبدل به Python، JavaScript یا هر زبان دیگری تبدیل کنید.

از فلگ -H برای هر هدر استفاده کنید: curl -H "Content-Type: application/json" -H "Accept: application/json" https://api.example.com. Content-Type به سرور می‌گوید بدنه درخواست در چه فرمتی است؛ Accept به سرور می‌گوید پاسخ را در چه فرمتی می‌خواهید. در سازنده cURL، این هدرها را در تب هدرها اضافه کنید — یا Content-Type هنگام انتخاب نوع بدنه به صورت خودکار تنظیم می‌شود.

از -H (یا --header) برای هر هدر استفاده کنید: curl -H "X-Request-ID: abc123" -H "User-Agent: MyApp/1.0" https://api.example.com. می‌توانید هر تعداد فلگ -H مورد نیاز اضافه کنید. هدرهای سفارشی رایج شامل X-API-Key، User-Agent، X-Request-ID و Cache-Control هستند. در سازنده cURL، تب هدرها یک ویرایشگر کلید-مقدار برای افزودن تعداد نامحدود هدرهای سفارشی ارائه می‌دهد.

برای داده‌های فرم رمزگذاری‌شده با URL، از -d استفاده کنید: curl -d "username=alice&password=secret" https://example.com/login. برای داده‌های فرم چندبخشی (آپلود فایل)، از -F استفاده کنید: curl -F "file=@photo.jpg" -F "description=My photo" https://example.com/upload. فلگ -F به صورت خودکار Content-Type: multipart/form-data را تنظیم می‌کند. در سازنده cURL، به تب بدنه بروید و داده‌های فرم یا چندبخشی را برای ساخت بصری این درخواست‌ها انتخاب کنید.

از فلگ -F همراه با @ برای ارجاع به یک فایل محلی استفاده کنید: curl -F "file=@/path/to/document.pdf" https://api.example.com/upload. می‌توانید چندین فایل آپلود کنید: curl -F "file1=@photo.jpg" -F "file2=@resume.pdf" URL. برای تنظیم نام فایل سفارشی یا نوع MIME: curl -F "file=@photo.jpg;filename=avatar.jpg;type=image/jpeg" URL. curl2code تمام این الگوها را به درستی به Python، Node.js، Go و زبان‌های دیگر تبدیل می‌کند.

از -d (یا --data) برای ارسال بدنه درخواست استفاده کنید: curl -d "raw text payload" https://api.example.com. برای داده‌های باینری یا مبتنی بر فایل، از --data-binary @file.bin استفاده کنید. از --data-raw برای ارسال رشته به صورت تحت‌اللفظی بدون تفسیر @ استفاده کنید: curl --data-raw {"key":"value"} URL. افزودن -d به صورت خودکار متد را روی POST و Content-Type را روی application/x-www-form-urlencoded تنظیم می‌کند — هنگام ارسال JSON یا متن ساده با -H آن را بازنویسی کنید. در سازنده cURL، از تب بدنه برای وارد کردن محتوای خام و انتخاب نوع محتوای مناسب استفاده کنید.

از -b برای ارسال کوکی‌ها استفاده کنید: curl -b "session=abc123; lang=en" https://example.com. برای ذخیره کوکی‌ها از یک پاسخ، از -c استفاده کنید: curl -c cookies.txt https://example.com/login. برای ارسال کوکی‌های ذخیره‌شده در درخواست بعدی: curl -b cookies.txt https://example.com/dashboard. هر دو را برای یک جریان نشست کامل ترکیب کنید: curl -c cookies.txt -b cookies.txt URL. curl2code رشته‌های کوکی -b را به درستی به مدیریت معادل کوکی در Python، JavaScript و بیش از 30 زبان دیگر از طریق مبدل تبدیل می‌کند.