可嵌入价格小组件
使用可嵌入小组件在任意网站上显示实时金属价格，无需编写后端代码，页面中也不会出现 API 密钥。在控制台中完成配置后复制嵌入代码，即可用于 HTML、WordPress 或 Shopify。
进阶主题 阅读约 4 分钟
概述
小组件是现成的价格看板，您可以在控制台中进行配置，然后嵌入任何网站。它们直接从 MetalAPI 加载，因此无需编写后端代码，您的 API 密钥也绝不会出现在页面中。
每个套餐都包含小组件：Free 1 个，Lite 3 个，Standard 10 个，Enterprise 最多 500 个。您可以在小组件页面查看示例。
创建小组件
- 登录后在控制台中打开 Widgets。
- 新建一个小组件并为其命名。
- 选择要显示的品种（金属、能源、货币或加密货币）以及计价货币。
- 选择布局和主题，然后保存。
- 复制嵌入代码。
嵌入到您的网站
将控制台中的嵌入代码粘贴到希望显示小组件的位置。小组件由 metalapi.com/embed/… 提供，可被任何网站以框架形式嵌入，因此无论是纯 HTML 页面、WordPress、Shopify 主题还是建站工具都能使用。嵌入代码如下所示：
html
<iframe
src="https://metalapi.com/embed/YOUR_WIDGET_ID"
title="Live precious metal prices"
width="100%"
height="320"
style="border:0"
loading="lazy"
></iframe>请使用控制台中提供的完整代码片段，因为其中包含您小组件的 ID。
更新小组件
您在控制台中保存的更改会应用到所有嵌入了该小组件的页面，无需更新网站上的代码片段。
何时改用 API
小组件适用于展示价格这一常见场景。如果您需要自定义设计、进行计算或在应用中使用价格，请从服务器调用 API，或在浏览器中使用域名限制密钥调用。
相关指南
Webhook 与价格提醒当价格突破您设定的阈值时，接收带签名的 HTTP 回调，并使用 HMAC-SHA256 验证签名。本指南介绍提醒条件、负载格式、Node.js 与 PHP 验证代码以及重试机制。阅读约 7 分钟获取历史数据查询可追溯至 1999 年的每日价格，获取日期区间数据，比较两个日期之间的涨跌，获取 OHLC 日线数据，并利用 MetalAPI 历史数据分析黄金等品种的价格趋势。阅读约 7 分钟最佳实践合理缓存、批量请求多个品种、用实时流代替轮询，并确保 API 密钥和 Webhook 的安全。这些 MetalAPI 集成最佳实践可帮助您节省配额，提升性能与稳定性。阅读约 6 分钟
准备好开始构建了吗？
创建免费账户获取 API 密钥，或在 API 参考中浏览所有端点。