curl を Swift に変換

Q: Swift URLSessionとは何ですか？

URLSessionは、iOS、macOS、watchOS、およびtvOS向けのApple純正HTTPクライアントです。データタスク、ダウンロード、アップロード、WebSocket、およびバックグラウンド転送を処理します。Foundationの一部であるため、パッケージのインストールは不要です。HTTP/2、キャッシュ、およびクッキー管理をサポートしています。curl2codeは、すべてのSwift変換においてURLSessionコードを生成します。

Q: URLSessionとAlamofire、どちらを使うべきですか？

URLSessionは標準搭載されており、ほとんどのニーズをカバーしています。サードパーティへの依存を避けるためにこれを使用してください。Alamofireは、チェーン可能なリクエストビルダー、自動リトライ、レスポンス検証、マルチパートアップロードなどの利便性を提供します。小規模なプロジェクトではURLSessionで十分です。同様の標準的なアプローチについては、curl to Kotlin コンバーターまたはcurl to Objective-Cを参照してください。

Q: Swiftで認証を処理するにはどうすればよいですか？

URLRequestにヘッダーを設定します：request.setValue("Bearer \(token)", forHTTPHeaderField: "Authorization")。Basic認証の場合は、Data("\(user):\(pass)".utf8).base64EncodedString()でエンコードします。curl2codeは、-uおよびBearerヘッダーフラグを自動的にSwiftコードに変換します。

Q: Swiftでマルチパートフォームデータを送信するにはどうすればよいですか？

マルチパートのボディを手動で構築します。バウンダリ文字列を生成し、各フィールド/ファイルをCRLF区切りで追加し、Content-Type: multipart/form-data; boundary=...を設定します。より簡単なマルチパート送信には、Alamofireのupload(multipartFormData:)を使用してください。curl2codeは、URLSession向けの-Fフラグ変換を処理します。

Q: SwiftでHTTPエラーを処理するにはどうすればよいですか？

URLSessionは完了ハンドラーでオプショナルのErrorを返します。nilかどうかを確認してください。レスポンスをHTTPURLResponseにキャストし、statusCodeを確認します。async/await（iOS 15以降）を使用する場合は、do/catchブロック内でtry await URLSession.shared.data(for: request)を使用して、クリーンなエラー処理を行います。

Q: URLSessionでasync/awaitを使用するにはどうすればよいですか？

Swift 5.5以降はasync/awaitをネイティブでサポートしています：let (data, response) = try await URLSession.shared.data(for: request)。これにより、完了ハンドラーのクロージャが線形なコードに置き換わります。同期コンテキストから呼び出すには、Task { }を使用します。並列リクエストの場合は、async letまたはTaskGroupを使用してください。同様のパターンについては、curl to 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: SwiftでJSONボディを含むPOSTリクエストを送信する方法は？

curl2codeを使用して、curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URLのようなcurlのPOSTコマンドをSwiftに変換します。生成されたコードではrequest.httpBody = try JSONEncoder().encode(data)を使用します。curl2codeはJSONコンテンツを含む-d/--dataフラグを自動的に検出し、URLSessionのコードに適切なContent-Typeヘッダーを設定します。

Q: SwiftでBearerトークン認証を追加する方法は？

curl -H "Authorization: Bearer YOUR_TOKEN" URLをcurl2codeに渡すと、認証ヘッダーrequest.setValue("Bearer YOUR_TOKEN", forHTTPHeaderField: "Authorization")を含むURLSessionのコードが生成されます。curl2codeは-H "Authorization: Bearer ..."と--oauth2-bearerフラグの両方からBearerトークンを検出します。Basic authの場合は、-u user:passを使用してください。

URLSession を使用して、curl コマンドを Swift コードに変換します。curl2code は WebAssembly を介してブラウザ内で完全に動作するため、データは非公開に保たれます。Kotlin (Android) については、curl to Kotlin 変換ツールをお試しください。Objective-C については、curl to Objective-C をご覧ください。以下に、すぐに使える Swift の例を掲載しています。

ブラウザから curl をコピーする方法

1
デベロッパーツールを開く
F12 キーを押すか、Ctrl+Shift+Iを使用してブラウザのデベロッパーツールを開きます。
2
ネットワークタブに移動
ネットワークタブをクリックし、HTTP リクエストをトリガーするアクションを実行します。
3
cURL としてコピー
リクエストを右クリック → コピー → 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()

2JSON ボディを含む POST

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()

3Bearer トークンを使用したリクエスト

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マルチパートフォームのアップロード

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は、iOS、macOS、watchOS、およびtvOS向けのApple純正HTTPクライアントです。データタスク、ダウンロード、アップロード、WebSocket、およびバックグラウンド転送を処理します。Foundationの一部であるため、パッケージのインストールは不要です。HTTP/2、キャッシュ、およびクッキー管理をサポートしています。curl2codeは、すべてのSwift変換においてURLSessionコードを生成します。

URLSessionとAlamofire、どちらを使うべきですか？

URLSessionは標準搭載されており、ほとんどのニーズをカバーしています。サードパーティへの依存を避けるためにこれを使用してください。Alamofireは、チェーン可能なリクエストビルダー、自動リトライ、レスポンス検証、マルチパートアップロードなどの利便性を提供します。小規模なプロジェクトではURLSessionで十分です。同様の標準的なアプローチについては、curl to Kotlin コンバーターまたはcurl to Objective-Cを参照してください。

Swiftで認証を処理するにはどうすればよいですか？

URLRequestにヘッダーを設定します：request.setValue("Bearer \(token)", forHTTPHeaderField: "Authorization")。Basic認証の場合は、Data("\(user):\(pass)".utf8).base64EncodedString()でエンコードします。curl2codeは、-uおよびBearerヘッダーフラグを自動的にSwiftコードに変換します。

Swiftでマルチパートフォームデータを送信するにはどうすればよいですか？

マルチパートのボディを手動で構築します。バウンダリ文字列を生成し、各フィールド/ファイルをCRLF区切りで追加し、Content-Type: multipart/form-data; boundary=...を設定します。より簡単なマルチパート送信には、Alamofireのupload(multipartFormData:)を使用してください。curl2codeは、URLSession向けの-Fフラグ変換を処理します。

SwiftでHTTPエラーを処理するにはどうすればよいですか？

URLSessionは完了ハンドラーでオプショナルのErrorを返します。nilかどうかを確認してください。レスポンスをHTTPURLResponseにキャストし、statusCodeを確認します。async/await（iOS 15以降）を使用する場合は、do/catchブロック内でtry await URLSession.shared.data(for: request)を使用して、クリーンなエラー処理を行います。

URLSessionでasync/awaitを使用するにはどうすればよいですか？

Swift 5.5以降はasync/awaitをネイティブでサポートしています：let (data, response) = try await URLSession.shared.data(for: request)。これにより、完了ハンドラーのクロージャが線形なコードに置き換わります。同期コンテキストから呼び出すには、Task { }を使用します。並列リクエストの場合は、async letまたはTaskGroupを使用してください。同様のパターンについては、curl to 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の設定で構成されたシステム全体のプロキシ設定も尊重します。

SwiftでJSONボディを含むPOSTリクエストを送信する方法は？

curl2codeを使用して、curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URLのようなcurlのPOSTコマンドをSwiftに変換します。生成されたコードではrequest.httpBody = try JSONEncoder().encode(data)を使用します。curl2codeはJSONコンテンツを含む-d/--dataフラグを自動的に検出し、URLSessionのコードに適切なContent-Typeヘッダーを設定します。

SwiftでBearerトークン認証を追加する方法は？

curl -H "Authorization: Bearer YOUR_TOKEN" URLをcurl2codeに渡すと、認証ヘッダーrequest.setValue("Bearer YOUR_TOKEN", forHTTPHeaderField: "Authorization")を含むURLSessionのコードが生成されます。curl2codeは-H "Authorization: Bearer ..."と--oauth2-bearerフラグの両方からBearerトークンを検出します。Basic authの場合は、-u user:passを使用してください。

SwiftでContent-Typeヘッダーを設定する方法は？

curl2codeはcurl -H "Content-Type: application/json" URLを、適切なヘッダーrequest.setValue("application/json", forHTTPHeaderField: "Content-Type")を含むURLSessionのコードに変換します。-dデータの場合、curlはデフォルトでapplication/x-www-form-urlencodedを使用し、-Fフォームアップロードの場合はmultipart/form-dataを使用します。curl2codeはそれぞれを正しいURLSession APIにマッピングします。

便利なリンク

URLSession ドキュメント

developer.apple.com

標準ライブラリリファレンス

github.com

curl man ページ

curl.se

curl ガイド

curl エラーコード

curl の終了コードを検索 — 原因、修正方法、デバッグのヒント。

curl でファイルをダウンロード

-o、-O でファイルを保存、リダイレクトの追跡、ダウンロードの再開など。

SSL、TLS、プロキシ

証明書、TLS バージョン、HTTP/SOCKS プロキシ、カスタム DNS の設定。

ブラウザから curl をコピーする方法

Swift のコード例

1シンプルな GET リクエスト

2JSON ボディを含む POST

3Bearer トークンを使用したリクエスト

4マルチパートフォームのアップロード

5カスタムヘッダー

よくある質問

便利なリンク

curl ガイド

curl を他の言語に変換

Swift のコード例

1シンプルな GET リクエスト

2JSON ボディを含む POST

3Bearer トークンを使用したリクエスト

4マルチパートフォームのアップロード

5カスタムヘッダー