在网站中粘贴一个 iframe,即可添加免费的货币换算小工具。访客可在小工具内更改金额和货币,你无需 API 密钥。
将换算工具添加到页面
将以下代码粘贴到允许 iframe 的页面,例如页面构建器中的自定义 HTML 或嵌入区块。框架宽度为100%,高度为380像素,无边框,最大宽度为420像素。
<iframe src="https://exchangerate.dev/embed/converter?from=USD&to=EUR&amount=100&lang=zh" title="货币换算" width="100%" height="380" style="border:0;max-width:420px" loading="lazy"></iframe>选择初始设置
将 from 和 to 设为三字母货币代码,将 amount 设为数字。默认值分别为 USD、EUR 和100。未列出的货币代码会回退到默认值,超出允许范围的金额会回退到100。
将 theme 设为 auto、light 或 dark。默认值 auto 跟随访客的系统设置。lang 可设为 en、ar、es、id、ja、ko、pl、th、tr 或 zh,默认值为 en。
| 参数 | 含义 | 默认值 |
|---|---|---|
from | 源货币的三字母代码 | USD |
to | 目标货币的三字母代码 | EUR |
amount | 待换算的初始金额 | 100 |
theme | 主题,auto 跟随访客的系统设置 | auto |
lang | 小工具使用的语言 | en |
汇率与访客操作
框架加载一次滞后市场15分钟的汇率,并显示 UTC 时间戳。重新加载可获取更新的汇率,框架不会自动刷新。
货币列表显示 USD、EUR 等代码。访客可更改金额、选择任一货币或交换两种货币。这些操作在浏览器内完成,不会发出请求。
何时调用 API
如需自建界面、付费套餐的实时汇率、历史数据或在代码中换算,请使用 API。免费套餐每月有 5,000 次请求,每分钟有 10 次请求。