在 C# 与 .NET 中使用汇率
使用 IHttpClientFactory、decimal、取消令牌、有限超时与来源感知处理构建带类型的 .NET 汇率客户端。
为 exchangerate.dev 注册一个带类型的 HttpClient,从配置注入 API 密钥,并将汇率反序列化为 decimal。传递取消令牌并设置有限超时,避免上游慢请求长期占用应用请求。
Key points
使用
IHttpClientFactory 统一管理连接与客户端配置。把汇率反序列化为
decimal 并保留新鲜度字段。传递
CancellationToken 并设置超时。解码前调用
EnsureSuccessStatusCode()。注册带类型的 HttpClient
注册配置基础 URL、bearer token 与超时。带类型的客户端负责响应契约,并把调用方的取消传给网络请求。
从请求传递取消令牌
只缓存成功观测
共享缓存应保存完整观测,而不是只存 Rates["EUR"]。保留 Source、MarketSession 与 DataUpdatedAt,调用方才能区分实时交易日更新、每日参考值与闭市值。
重试策略必须收窄
短暂网络故障或部分 5xx 可以小幅退避后重试。不要把 401 当成短暂故障,也不要在 429 后制造重试风暴。应先通过缓存和请求合并消除重复流量。
- 保留一个带类型的客户端注册。
- 汇率与金额使用 decimal。
- 在完整调用链中传递取消。
- 反序列化前拒绝非成功响应。
ER
exchangerate.dev
面向使用外汇数据的开发者的集成指南。