Tutorial/Swift 快速入門

用 Swift URLSession 攞匯率

用 URLSession、Codable 同 URLComponents,保留匯率回應嘅更新資料。

ERexchangerate.dev·Sep 8, 2026·閱讀約 6 分鐘

網絡請求用 URLSession,JSON 用 Codable。真正嘅 key 要放喺伺服器,唔好放入 iOS、macOS 或 watchOS app。

Key points
定義回應模型: 模型保留 rates、source、market_session 同 data_updated_at。金額計算用 Decimal,避免 Double 嘅二進制誤差。
將 key 留喺伺服器: 手機 app 呼叫自己嘅 backend,再由 backend 加 Authorization。伺服器 Swift 可以由環境變數讀 key。
處理狀態同新鮮度: 解碼之前先檢查 HTTP 狀態,分開處理 401 同 429,並保留時間同來源。

定義回應模型

模型保留 rates、source、market_session 同 data_updated_at。金額計算用 Decimal,避免 Double 嘅二進制誤差。

swift · ExchangeRateClient.swiftcopy
import Foundation

final class NoRedirects: NSObject, URLSessionTaskDelegate {
    func urlSession(_ session: URLSession, task: URLSessionTask, willPerformHTTPRedirection response: HTTPURLResponse, newRequest request: URLRequest, completionHandler: @escaping (URLRequest?) -> Void) {
        completionHandler(nil)
    }
}

struct Latest: Decodable {
    let base: String
    let source: String
    let marketSession: String
    let dataUpdatedAt: String
    let rates: [String: Decimal]
}

struct ExchangeRateClient {
    let session: URLSession
    let apiKey: String?

    func latest(base: String) async throws -> Latest {
        let normalizedBase = base.uppercased()
        guard normalizedBase.count == 3, normalizedBase.allSatisfy({ $0.isASCII && $0.isLetter }) else {
            throw URLError(.badURL)
        }
        guard var components = URLComponents(string: "https://api.exchangerate.dev/v1/latest/\(normalizedBase)") else {
            throw URLError(.badURL)
        }
        components.queryItems = [URLQueryItem(name: "symbols", value: "EUR,GBP,JPY")]
        guard let url = components.url else { throw URLError(.badURL) }
        var request = URLRequest(url: url)
        request.timeoutInterval = 10
        if let apiKey { request.setValue("Bearer \(apiKey)", forHTTPHeaderField: "Authorization") }

        let (data, response) = try await session.data(for: request)
        guard let http = response as? HTTPURLResponse, (200..<300).contains(http.statusCode) else {
            throw URLError(.badServerResponse)
        }
        let decoder = JSONDecoder()
        decoder.keyDecodingStrategy = .convertFromSnakeCase
        return try decoder.decode(Latest.self, from: data)
    }
}

將 key 留喺伺服器

手機 app 呼叫自己嘅 backend,再由 backend 加 Authorization。伺服器 Swift 可以由環境變數讀 key。

swift · server setupcopy
let key = ProcessInfo.processInfo.environment["EXCHANGERATE_API_KEY"]
let session = URLSession(configuration: .ephemeral, delegate: NoRedirects(), delegateQueue: nil)
let client = ExchangeRateClient(
    session: session,
    apiKey: key
)
let latest = try await client.latest(base: "USD")
print(latest.rates["EUR"] as Any, latest.source, latest.dataUpdatedAt)

處理狀態同新鮮度

解碼之前先檢查 HTTP 狀態,分開處理 401 同 429,並保留時間同來源。

一齊保存匯率上下文
日報可以每日呼叫一次,營運 dashboard 可以每個鐘呼叫一次。收到 429 就降低頻率,唔好即時製造重試風暴。
  • 將匯率連同來源同時間保存。
  • 用作自動化、估算、報表同分析。
  • 唔好當成可以成交嘅報價。
ER
exchangerate.dev
為開發者提供嘅整合指南。

延伸閱讀

Reference匯率 API 快速入門閱讀 TutorialJavaScript / Node.js閱讀 Guide一齊保存匯率上下文閱讀
更多比較Fixer vs exchangerate.devOpen Exchange Rates vs exchangerate.devCurrencylayer vs exchangerate.dev
學習Reading source and market_session in your pipelineIndicative vs executable FX rates: what a rates API actually gives youECB reference rates, explained
即時匯率EUR/USDGBP/USDUSD/JPY