exchangerate.dev网络请求使用 URLSession，JSON 使用 Codable。真实密钥应放在服务器，不能嵌入 iOS、macOS 或 watchOS 应用。
- 定义响应模型: 模型保留 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.swift
import Foundationfinal 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 setup
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 时降低频率，不要立即制造重试风暴。
- 把汇率与来源和时间一起保存。
- 用于自动化、估算、报表和分析。
- 不要当作可成交报价。