המרת curl ל-PowerShell

Invoke-RestMethod הוא cmdlet מובנה ב-PowerShell לביצוע בקשות HTTP עם פענוח אוטומטי של JSON/XML. הוא מחזיר אובייקטים מפוענחים ישירות — ללא צורך בדה-סריאליזציה ידנית. זמין ב-PowerShell 3.0+ וב-PowerShell Core. curl2code תומך גם ב-Invoke-WebRequest המחזיר את התגובה הגולמית.

Invoke-RestMethod מפענח אוטומטית תגובות JSON/XML לאובייקטים של PowerShell — אידיאלי לעבודה עם API. Invoke-WebRequest מחזיר את התגובה המלאה עם כותרות, קוד סטטוס ותוכן גולמי — טוב יותר לניפוי שגיאות ותגובות שאינן JSON. השתמש ב-RestMethod עבור ממשקי API, וב-WebRequest לגירוד נתונים (scraping) או אבחון. לגישת .NET דומה, ראה curl ל-C#.

עבור Bearer: Invoke-RestMethod -Uri $url -Headers @{ Authorization = "Bearer $token" }. עבור Basic auth, השתמש ב--Credential (Get-Credential) או ב--Authentication Basic (PowerShell 6+). PowerShell מטפל בפרטי אימות בצורה מאובטחת עם SecureString. curl2code ממיר דגלי אימות לפרמטרים של cmdlet ב-PowerShell.

PowerShell 6+ תומך ב--Form @{ file = Get-Item "doc.pdf"; desc = "My file" } להעלאות multipart. ב-Windows PowerShell 5.1, בנה את גוף ה-multipart ידנית או השתמש במחלקות .NET (כמו System.Net.Http.MultipartFormDataContent). curl2code מטפל בהמרת דגל -F.

השתמש ב-try/catch: שני ה-cmdlets זורקים WebException בתגובות שאינן 2xx. גש לתגובה באמצעות $_.Exception.Response. ב-PowerShell 7+, השתמש ב--SkipHttpErrorCheck כדי למנוע זריקת שגיאה ולבדוק את $response.StatusCode ידנית במקום זאת.

Invoke-RestMethod מפענח JSON אוטומטית ל-PSObject. להמרה ידנית: $data = $json | ConvertFrom-Json. לשליחת JSON: $body = @{ name = "John" } | ConvertTo-Json. צינור האובייקטים (object pipeline) של PowerShell משתלב בטבעיות עם תגובות API מפוענחות לצורך סינון וטרנספורמציה.

השתמש בפרמטר -TimeoutSec 30 בשני ה-cmdlets. ב-PowerShell 7+, השתמש ב--ConnectionTimeoutSeconds וב--OperationTimeoutSeconds לשליטה מדויקת. עבור ניסיונות חוזרים, השתמש ב--MaximumRetryCount 3 וב--RetryIntervalSec 2 (PowerShell 7.1+).

השתמש בפרמטר -Proxy 'http://proxy:8080'. עבור אימות פרוקסי: -ProxyCredential (Get-Credential). PowerShell מכבד הגדרות פרוקסי של המערכת כברירת מחדל ב-Windows. כדי לעקוף: -NoProxy (PowerShell 6+). curl2code ממיר דגלי -x לפרמטרים של פרוקסי ב-PowerShell.

המירו פקודת curl POST כמו curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL ל-PowerShell באמצעות curl2code. הקוד שנוצר משתמש ב-Invoke-RestMethod -Uri $url -Method Post -Body ($data | ConvertTo-Json) -ContentType 'application/json'. curl2code מזהה באופן אוטומטי דגלי -d/--data עם תוכן JSON ומגדיר את כותרת Content-Type המתאימה בקוד ה-Invoke-RestMethod.

העבירו את curl -H "Authorization: Bearer YOUR_TOKEN" URL ל-curl2code והוא יפיק קוד Invoke-RestMethod עם כותרת האימות: -Headers @{ Authorization = 'Bearer YOUR_TOKEN' }. curl2code מזהה Bearer tokens גם מדגלי -H "Authorization: Bearer ..." וגם מדגלי --oauth2-bearer. עבור Basic auth, השתמשו ב--u user:pass.

curl2code ממיר את curl -H "Content-Type: application/json" URL לקוד Invoke-RestMethod עם הכותרת המתאימה: -ContentType 'application/json'. עבור נתוני -d, curl משתמש כברירת מחדל ב-application/x-www-form-urlencoded; עבור העלאות טפסים עם -F, הוא משתמש ב-multipart/form-data. curl2code ממפה כל אחד מהם ל-API הנכון של Invoke-RestMethod.