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

Q: Що таке Swift URLSession?

URLSession — це вбудований HTTP-клієнт Apple для iOS, macOS, watchOS та tvOS. Він обробляє завдання даних, завантаження, вивантаження, WebSocket та фонову передачу. Встановлення пакетів не потрібне — це частина Foundation. Підтримує HTTP/2, кешування та керування файлами cookie. curl2code генерує код URLSession для всіх перетворень Swift.

Q: URLSession проти Alamofire — що вибрати?

URLSession є вбудованим і задовольняє більшість потреб — використовуйте його, щоб уникнути сторонніх залежностей. Alamofire додає зручності: ланцюжкові конструктори запитів, автоматичне повторення, валідацію відповідей та завантаження multipart. Для невеликих проєктів достатньо URLSession. Для подібних вбудованих підходів дивіться наш конвертер curl у Kotlin або curl в Objective-C.

Q: Як обробляти автентифікацію у Swift?

Встановіть заголовок у URLRequest: request.setValue("Bearer \(token)", forHTTPHeaderField: "Authorization"). Для Basic-автентифікації закодуйте за допомогою Data("\(user):\(pass)".utf8).base64EncodedString(). curl2code автоматично перетворює прапорці -u та заголовки Bearer у код Swift.

Q: Як обробляти помилки HTTP у Swift?

URLSession повертає опціональну Error у замиканнях — перевірте її на nil. Приведіть відповідь до HTTPURLResponse і перевірте statusCode. З async/await (iOS 15+) використовуйте try await URLSession.shared.data(for: request) у блоці do/catch для чистої обробки помилок.

Q: Як використовувати async/await з URLSession?

Swift 5.5+ підтримує async/await нативно: let (data, response) = try await URLSession.shared.data(for: request). Це замінює замикання обробників завершення лінійним кодом. Використовуйте Task { } для виклику із синхронних контекстів. Для паралельних запитів використовуйте async let або TaskGroup. Для подібних патернів дивіться curl у Dart.

Q: Як встановити таймаути у Swift URLSession?

Налаштуйте в URLSessionConfiguration: config.timeoutIntervalForRequest = 30 (для запиту) та config.timeoutIntervalForResource = 300 (загальний). Або встановіть request.timeoutInterval = 30 для окремих запитів. Вони відповідають опціям curl --max-time та --connect-timeout.

Q: Як використовувати проксі з URLSession?

Встановіть проксі в URLSessionConfiguration: config.connectionProxyDictionary = [kCFProxyHostNameKey: "proxy", kCFProxyPortNumberKey: 8080]. Для SOCKS-проксі використовуйте ключі kCFStreamPropertySOCKSProxy. URLSession також враховує загальносистемні налаштування проксі, налаштовані в параметрах macOS/iOS.

Q: Як надіслати POST-запит із тілом JSON у Swift?

Конвертуйте команду curl POST, таку як curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL, у Swift за допомогою curl2code. Згенерований код використовує request.httpBody = try JSONEncoder().encode(data). curl2code автоматично виявляє прапорці -d/--data із вмістом JSON і встановлює відповідний заголовок Content-Type у коді URLSession.

Q: Як додати авторизацію за допомогою Bearer-токена у Swift?

Передайте curl -H "Authorization: Bearer YOUR_TOKEN" URL у curl2code, і він згенерує код URLSession із заголовком авторизації: request.setValue("Bearer YOUR_TOKEN", forHTTPHeaderField: "Authorization"). curl2code виявляє Bearer-токени як у прапорцях -H "Authorization: Bearer ...", так і в --oauth2-bearer. Для Basic auth використовуйте -u user:pass.

Конвертуйте команди curl у код Swift за допомогою URLSession. curl2code працює повністю у вашому браузері через WebAssembly — ваші дані залишаються приватними. Для Kotlin (Android) спробуйте наш конвертер curl у Kotlin. Для Objective-C дивіться curl у Objective-C. Нижче наведено готові до використання приклади на Swift.

Як скопіювати curl з вашого браузера

1
Відкрийте DevTools
Натисніть F12 або Ctrl+Shift+I, щоб відкрити інструменти розробника у вашому браузері.
2
Перейдіть на вкладку Network
Натисніть на вкладку Network і виконайте дію, яка ініціює HTTP-запит.
3
Скопіюйте як cURL
Клацніть правою кнопкою миші на запит → Copy → Copy as cURL. Потім вставте його вище.

Приклади коду на Swift

1Простий GET-запит

команда curl

curl https://api.example.com/users

Swift · URLSession

import Foundation

let url = URL(string: "https://api.example.com/users")!

var request = URLRequest(url: url)

let task = URLSession.shared.dataTask(with: request) { (data, response, error) in
    if let error = error {
        print(error)
    } else if let data = data {
        let str = String(data: data, encoding: .utf8)
        print(str ?? "")
    }
}

task.resume()

2POST із тілом JSON

команда curl

curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -d '{"name":"John","email":"john@example.com"}'

Swift · URLSession

import Foundation

let jsonData = [
    "name": "John",
    "email": "john@example.com"
] as [String : Any]
let data = try! JSONSerialization.data(withJSONObject: jsonData, options: [])

let url = URL(string: "https://api.example.com/users")!
let headers = [
    "Content-Type": "application/json"
]

var request = URLRequest(url: url)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = data as Data

let task = URLSession.shared.dataTask(with: request) { (data, response, error) in
    if let error = error {
        print(error)
    } else if let data = data {
        let str = String(data: data, encoding: .utf8)
        print(str ?? "")
    }
}

task.resume()

3Запит із Bearer-токеном

команда curl

curl https://api.example.com/me \
  -H "Authorization: Bearer token123"

Swift · URLSession

import Foundation

let url = URL(string: "https://api.example.com/me")!
let headers = [
    "Authorization": "Bearer token123"
]

var request = URLRequest(url: url)
request.allHTTPHeaderFields = headers

let task = URLSession.shared.dataTask(with: request) { (data, response, error) in
    if let error = error {
        print(error)
    } else if let data = data {
        let str = String(data: data, encoding: .utf8)
        print(str ?? "")
    }
}

task.resume()

4Завантаження форми Multipart

команда curl

curl -X POST https://api.example.com/upload \
  -F "file=@document.pdf" \
  -F "description=My file"

Swift · URLSession

import Foundation

let url = URL(string: "https://api.example.com/upload")!

var request = URLRequest(url: url)
request.httpMethod = "POST"

let task = URLSession.shared.dataTask(with: request) { (data, response, error) in
    if let error = error {
        print(error)
    } else if let data = data {
        let str = String(data: data, encoding: .utf8)
        print(str ?? "")
    }
}

task.resume()

5Користувацькі заголовки

команда curl

curl https://api.example.com/data \
  -H "X-API-Key: abc123" \
  -H "Accept: application/json" \
  -H "X-Request-ID: req-456"

Swift · URLSession

import Foundation

let url = URL(string: "https://api.example.com/data")!
let headers = [
    "X-API-Key": "abc123",
    "Accept": "application/json",
    "X-Request-ID": "req-456"
]

var request = URLRequest(url: url)
request.allHTTPHeaderFields = headers

let task = URLSession.shared.dataTask(with: request) { (data, response, error) in
    if let error = error {
        print(error)
    } else if let data = data {
        let str = String(data: data, encoding: .utf8)
        print(str ?? "")
    }
}

task.resume()

Часті запитання

Що таке Swift URLSession?

URLSession — це вбудований HTTP-клієнт Apple для iOS, macOS, watchOS та tvOS. Він обробляє завдання даних, завантаження, вивантаження, WebSocket та фонову передачу. Встановлення пакетів не потрібне — це частина Foundation. Підтримує HTTP/2, кешування та керування файлами cookie. curl2code генерує код URLSession для всіх перетворень Swift.

URLSession проти Alamofire — що вибрати?

URLSession є вбудованим і задовольняє більшість потреб — використовуйте його, щоб уникнути сторонніх залежностей. Alamofire додає зручності: ланцюжкові конструктори запитів, автоматичне повторення, валідацію відповідей та завантаження multipart. Для невеликих проєктів достатньо URLSession. Для подібних вбудованих підходів дивіться наш конвертер curl у Kotlin або curl в Objective-C.

Як обробляти автентифікацію у Swift?

Встановіть заголовок у URLRequest: request.setValue("Bearer \(token)", forHTTPHeaderField: "Authorization"). Для Basic-автентифікації закодуйте за допомогою Data("\(user):\(pass)".utf8).base64EncodedString(). curl2code автоматично перетворює прапорці -u та заголовки Bearer у код Swift.

Як надіслати дані форми multipart у Swift?

Сконструюйте тіло multipart вручну: згенеруйте рядок межі (boundary), додайте кожне поле/файл із роздільниками CRLF і встановіть Content-Type: multipart/form-data; boundary=.... Для простішого використання multipart використовуйте upload(multipartFormData:) в Alamofire. curl2code обробляє перетворення прапорця -F для URLSession.

Як обробляти помилки HTTP у Swift?

URLSession повертає опціональну Error у замиканнях — перевірте її на nil. Приведіть відповідь до HTTPURLResponse і перевірте statusCode. З async/await (iOS 15+) використовуйте try await URLSession.shared.data(for: request) у блоці do/catch для чистої обробки помилок.

Як використовувати async/await з URLSession?

Swift 5.5+ підтримує async/await нативно: let (data, response) = try await URLSession.shared.data(for: request). Це замінює замикання обробників завершення лінійним кодом. Використовуйте Task { } для виклику із синхронних контекстів. Для паралельних запитів використовуйте async let або TaskGroup. Для подібних патернів дивіться curl у Dart.

Як встановити таймаути у Swift URLSession?

Налаштуйте в URLSessionConfiguration: config.timeoutIntervalForRequest = 30 (для запиту) та config.timeoutIntervalForResource = 300 (загальний). Або встановіть request.timeoutInterval = 30 для окремих запитів. Вони відповідають опціям curl --max-time та --connect-timeout.

Як використовувати проксі з URLSession?

Встановіть проксі в URLSessionConfiguration: config.connectionProxyDictionary = [kCFProxyHostNameKey: "proxy", kCFProxyPortNumberKey: 8080]. Для SOCKS-проксі використовуйте ключі kCFStreamPropertySOCKSProxy. URLSession також враховує загальносистемні налаштування проксі, налаштовані в параметрах macOS/iOS.

Як надіслати POST-запит із тілом JSON у Swift?

Конвертуйте команду curl POST, таку як curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL, у Swift за допомогою curl2code. Згенерований код використовує request.httpBody = try JSONEncoder().encode(data). curl2code автоматично виявляє прапорці -d/--data із вмістом JSON і встановлює відповідний заголовок Content-Type у коді URLSession.

Як додати авторизацію за допомогою Bearer-токена у Swift?

Передайте curl -H "Authorization: Bearer YOUR_TOKEN" URL у curl2code, і він згенерує код URLSession із заголовком авторизації: request.setValue("Bearer YOUR_TOKEN", forHTTPHeaderField: "Authorization"). curl2code виявляє Bearer-токени як у прапорцях -H "Authorization: Bearer ...", так і в --oauth2-bearer. Для Basic auth використовуйте -u user:pass.

Як встановити заголовок Content-Type у Swift?

curl2code конвертує curl -H "Content-Type: application/json" URL у код URLSession із відповідним заголовком: request.setValue("application/json", forHTTPHeaderField: "Content-Type"). Для даних -d curl за замовчуванням використовує application/x-www-form-urlencoded; для завантаження форм -F використовується multipart/form-data. curl2code зіставляє кожен варіант із правильним URLSession API.

Корисні посилання

Документація URLSession

developer.apple.com

Довідник стандартної бібліотеки

github.com

Сторінка man для curl

curl.se

Посібники з curl

Коди помилок curl

Знайдіть будь-який код завершення curl — причини, виправлення та поради з налагодження.

Завантаження файлів за допомогою curl

Зберігайте файли з -o, -O, слідкуйте за перенаправленнями, відновлюйте завантаження та інше.

SSL, TLS та проксі

Налаштування сертифікатів, версій TLS, HTTP/SOCKS-проксі та власного DNS.

Як скопіювати curl з вашого браузера

Приклади коду на Swift

1Простий GET-запит

2POST із тілом JSON

3Запит із Bearer-токеном

4Завантаження форми Multipart

5Користувацькі заголовки

Часті запитання

Корисні посилання

Посібники з curl

Конвертувати curl в інші мови

Приклади коду на Swift

1Простий GET-запит

2POST із тілом JSON

3Запит із Bearer-токеном

4Завантаження форми Multipart

5Користувацькі заголовки