ממיר cURL

מה זה ממיר cURL?

ממיר cURL הופך פקודת curl (הפורמט שכל תיעוד API, כל ייצוא מ-Postman וכל עוזר AI מפיקים) לקוד מוכן להדבקה בשפת התכנות שאתם באמת עובדים בה. כותרות, מחרוזות שאילתה, גופי JSON, העלאות multipart, אימות basic ועוגיות עוברים כולם, כך שלא צריך לתרגם את הבקשה ידנית.

curl היא הדרך האוניברסלית לתאר בקשת HTTP, אבל כמעט אף פעם לא *מריצים* curl בפרודקשן. מריצים fetch של JavaScript, requests של Python, net/http של Go או כל מה שה-stack שלכם משתמש בו. הכלי הזה מגשר על הפער: הדביקו את ה-curl, לחצו על לשונית והעתיקו את הקוד.

הכול רץ מקומית בדפדפן. פקודת ה-curl, הכותרות והטוקנים שלכם לא יוצאים מהמחשב, וזה חשוב כשמדביקים פקודות שכוללות bearer tokens אמיתיים או עוגיות session.

מה תלמדו תוך כדי המרה

• דגלי curl ממופים למושגים מוגדרים בכל לקוח HTTP: -H הוא כותרת בקשה, -d הוא גוף, -X הוא המתודה, -u הוא אימות basic, -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

   הדביקו את הפקודה המלאה, כולל המשכי שורה עם \ מתיעוד שהעתקתם, לתיבת הקלט. המפענח מנרמל מרכאות מסולסלות וסימני prompt של 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 token או עוגייה, החליפו את הערך המילולי במשתנה סביבה לפני ה-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 עם מרכאות מסולסלות (', ', ", ") מפוסט בבלוג. הן נראות כמו מרכאות אבל שוברות את הפענוח של ה-shell. הממיר מנרמל אותן, אבל אם אפשר, העתיקו את הפקודה המקורית.
• השארת -k (--insecure) בפרודקשן. הדגל מבטל את אימות תעודת ה-TLS: בסדר לפיתוח מקומי, מסוכן בתעבורה אמיתית.
• שכחה ש---data-raw ו---data מתנהגים אחרת: --data מקודד URL את הקלט. השתמשו ב---data-raw לגופי JSON שכוללים @ או &.
• הדבקת פקודת curl.exe של Windows בלי להמיר את המשכי השורה ^ ל-\. הממיר מטפל בזה, אבל המפענח מחמיר עם מרכאות, אז בדקו שוב את גבולות המחרוזות.
• העתקת bearer tokens או עוגיות לניהול גרסאות אחרי ההמרה. החליפו אותם במשתני סביבה (process.env.API_TOKEN, os.environ['API_TOKEN']) לפני ה-commit.

שאלות נפוצות על cURL Converter