Tutorial/Swift 快速入门

用 Swift 的 URLSession 获取汇率

使用 URLSession、Codable 和 URLComponents,并保留汇率响应的更新时间信息。

ERexchangerate.dev·Sep 8, 2026·阅读约 6 分钟

网络请求使用 URLSession,JSON 使用 Codable。真实密钥应放在服务器,不能嵌入 iOS、macOS 或 watchOS 应用。

Key points
定义响应模型: 模型保留 rates、source、market_session 和 data_updated_at。金额计算使用 Decimal,避免 Double 的二进制误差。
把密钥留在服务器: 移动端调用自己的后端,由后端添加 Authorization。服务端 Swift 可以从环境变量读取密钥。
处理状态和新鲜度: 解码前检查 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)
    }
}

把密钥留在服务器

移动端调用自己的后端,由后端添加 Authorization。服务端 Swift 可以从环境变量读取密钥。

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,并向用户展示时间和来源上下文。

同时保留汇率上下文
日报可以每天调用一次,运营看板可以每小时调用一次。收到 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