پرش به محتوای اصلی

راهنمای تبدیل cURL به کد

زمان مطالعه: ۲ دقیقه

این ابزار چیست؟

مستندات بیشتر APIها نمونه‌ها را به شکل دستور cURL می‌دهند و ابزار برنامه‌نویسی مرورگر هم هر درخواست را با «Copy as cURL» کپی می‌کند. این ابزار همان دستور را به کد آماده در JavaScript با fetch، Axios، Python با requests، Go، PHP و HTTPie تبدیل می‌کند و برعکس، یک فراخوانی fetch را به دستور cURL برمی‌گرداند.

سرآیندها، بدنه‌ی JSON، فرم، احراز هویت پایه و گزینه‌هایی مثل -k و -L شناخته می‌شوند و گزینه‌هایی که پشتیبانی نمی‌شوند جدا فهرست می‌شوند. تبدیل در مرورگر شما انجام می‌شود و چون دستورها اغلب توکن دارند، در تاریخچه ذخیره نمی‌شوند.

گام‌به‌گام

  1. جهت تبدیل را انتخاب کنید

    «cURL به کد» برای ساختن کد از دستور و «fetch به cURL» برای ساختن دستور از کد جاوااسکریپت.

  2. دستور را بچسبانید

    در مرورگر، در زبانه‌ی Network روی درخواست راست‌کلیک کنید، Copy as cURL را بزنید و دستور را در کادر «دستور cURL» بگذارید.

  3. زبان مقصد را انتخاب کنید

    از فهرست «کد» زبان و کتابخانه‌ی موردنظر را بردارید؛ خروجی همان لحظه ساخته می‌شود.

  4. هشدارها را ببینید

    اگر گزینه‌ای از دستور در زبان مقصد معادل ندارد یا پشتیبانی نمی‌شود، زیر خروجی فهرست می‌شود.

نمونه‌های کاربردی

  • درخواست POST با JSON به fetch

    بدنه‌ی JSON شناخته می‌شود و با JSON.stringify ساخته می‌شود؛ روش POST هم از وجود بدنه نتیجه گرفته می‌شود.

    curl 'https://api.example.ir/v1/users' -H 'Authorization: Bearer TOKEN' -H 'Content-Type: application/json' --data-raw '{"name":"سارا"}'

    نتیجه: const response = await fetch("https://api.example.ir/v1/users", { method: "POST", headers: { "Authorization": "Bearer TOKEN", "Content-Type": "application/json", }, body: JSON.stringify({ "name": "سارا" }), }); console.log(await response.text());

  • همان درخواست در Python

    با requests، بدنه‌ی JSON در پارامتر json می‌آید.

    curl 'https://api.example.ir/v1/users' -H 'Authorization: Bearer TOKEN' -H 'Content-Type: application/json' --data-raw '{"name":"سارا"}'

    نتیجه: import requests response = requests.post( "https://api.example.ir/v1/users", headers={ "Authorization": "Bearer TOKEN", "Content-Type": "application/json", }, json={ "name": "سارا", }, ) print(response.text)

  • fetch به cURL

    یک فراخوانی ساده‌ی fetch به دستوری تبدیل می‌شود که در ترمینال اجرا کنید.

    fetch("https://api.example.ir/v1/ping", { method: "POST" })

    نتیجه: curl 'https://api.example.ir/v1/ping' \ -X POST

اشتباه‌های رایج

  • چسباندن دستوری که توکن واقعی دارد در جاهای ناشناخته: Copy as cURL کوکی‌ها و توکن ورود شما را هم کپی می‌کند. این ابزار چیزی نمی‌فرستد، اما پیش از اشتراک کد با دیگران، توکن را بردارید.
  • کپی دستور cURL ویندوز در حالت پیش‌فرض: Chrome روی ویندوز دو گزینه‌ی cmd و bash دارد. گزینه‌ی bash نقل‌قول‌های قابل‌پیش‌بینی‌تری دارد.
  • نگه داشتن -k در کد نهایی: این گزینه بررسی گواهی TLS را خاموش می‌کند و فقط برای آزمایش است.
  • نادیده گرفتن فهرست پشتیبانی‌نشده: اگر گزینه‌ای کنار گذاشته شده، کد ساخته‌شده ممکن است درخواست کاملاً یکسانی نفرستد.

cURL چه می‌گوید؟

-H یک سرآیند می‌افزاید، -d یا --data-raw بدنه را می‌فرستد و اگر روش با -X مشخص نشده باشد، وجود بدنه یعنی POST. -u نام کاربری و گذرواژه‌ی احراز هویت پایه را می‌دهد، -L تغییر مسیرها را دنبال می‌کند و --compressed پاسخ فشرده را می‌پذیرد.

دانستن همین چند گزینه کافی است تا هر نمونه‌ی مستندات API را بخوانید و بفهمید کد ساخته‌شده دقیقاً چه درخواستی می‌فرستد.

پرسش‌های متداول

دستور «Copy as cURL (cmd)» ویندوز هم کار می‌کند؟
بله؛ نویسه‌ی ^ برای ادامه‌ی خط و فرار از نقل‌قول‌ها شناخته می‌شود. دستورهای bash، شامل رشته‌های $'…'، هم پشتیبانی می‌شوند.
با گزینه‌هایی که ابزار نمی‌شناسد چه می‌شود؟
دستور خراب نمی‌شود؛ گزینه‌های ناشناخته یا بی‌اثر در بخش «پشتیبانی نشده» فهرست می‌شوند و بقیه‌ی دستور تبدیل می‌شود.
اطلاعات حساس دستورم کجا می‌رود؟
تبدیل کاملاً در مرورگر انجام می‌شود و هیچ‌چیز ارسال یا ذخیره نمی‌شود. با این حال توکن و گذرواژه‌ی واقعی را در کدی که منتشر می‌کنید نگذارید.

ابزارهای مرتبط