基础 URL
LI.FI 的 API 基于 REST 原则构建,通过 HTTPS 提供服务。 所有 API 端点的基础 URL 是:身份验证
所有 LI.FI API 都不需要 API 密钥。API 密钥仅用于更高的速率限制
x-lifi-api-key
和 API 密钥执行。如果您使用客户端 SDK,您将在构建客户端时设置 API,然后 SDK 将在每个请求中代表您发送标头。如果直接与 API 集成,您需要自己发送此标头,如下所示:
永远不要在客户端环境中暴露您的
x-lifi-api-key
,例如基于浏览器的 JavaScript 或直接的小部件集成。在客户端使用 API 密钥可能导致未经授权的使用或滥用您的密钥,因为它会在浏览器的开发者工具或网络标签中公开可见。
如果您使用 LI.FI 小部件,您不需要传递 API 密钥。小部件在前端安全运行,无需密钥。对于服务器端集成(例如 SDK 或来自后端的 API 请求),请始终保持您的密钥机密和安全。 速率限制
速率限制在没有 API 密钥的情况下按 IP 计算,在有 API 密钥的认证请求中按 API 密钥计算。 请参考速率限制和 API 身份验证页面。错误消息
错误由三部分组成:- HTTP 错误代码
- LI.FI 错误代码
- 错误消息