Конвертувати curl у PowerShell

Invoke-RestMethod — це вбудований командлет PowerShell для виконання HTTP-запитів з автоматичним парсингом JSON/XML. Він повертає вже розпарсені об'єкти — ручна десеріалізація не потрібна. Доступний у PowerShell 3.0+ та PowerShell Core. curl2code також підтримує Invoke-WebRequest, який повертає сиру відповідь.

Invoke-RestMethod автоматично парсить відповіді JSON/XML в об'єкти PowerShell — ідеально для роботи з API. Invoke-WebRequest повертає повну відповідь із заголовками, кодом статусу та сирим вмістом — краще для налагодження та відповідей, що не є JSON. Використовуйте RestMethod для API, WebRequest для скрейпінгу або діагностики. Для схожого підходу в .NET див. curl до C#.

Для Bearer: Invoke-RestMethod -Uri $url -Headers @{ Authorization = "Bearer $token" }. Для Basic auth використовуйте -Credential (Get-Credential) або -Authentication Basic (PowerShell 6+). PowerShell безпечно обробляє облікові дані за допомогою SecureString. curl2code конвертує прапорці автентифікації в параметри командлета 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: обидва командлети видають WebException для відповідей, відмінних від 2xx. Отримайте доступ до відповіді через $_.Exception.Response. У PowerShell 7+ використовуйте -SkipHttpErrorCheck, щоб запобігти виклику винятку та замість цього перевіряти $response.StatusCode вручну.

Invoke-RestMethod автоматично парсить JSON у PSObject. Для ручної конвертації: $data = $json | ConvertFrom-Json. Щоб надіслати JSON: $body = @{ name = "John" } | ConvertTo-Json. Конвеєр об'єктів PowerShell природно інтегрується з розпарсеними відповідями API для фільтрації та трансформації.

Використовуйте параметр -TimeoutSec 30 в обох командлетах. У 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-токени як у прапорцях -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 зіставляє кожен варіант із правильним Invoke-RestMethod API.