跳转到主要内容

基础 URL

LI.FI 的 API 基于 REST 原则构建,通过 HTTPS 提供服务。 所有 API 端点的基础 URL 是:
https://li.quest/v1

身份验证

所有 LI.FI API 都不需要 API 密钥。API 密钥仅用于更高的速率限制
LI.FI API 的身份验证通过自定义 HTTP 标头 x-lifi-api-key 和 API 密钥执行。如果您使用客户端 SDK,您将在构建客户端时设置 API,然后 SDK 将在每个请求中代表您发送标头。如果直接与 API 集成,您需要自己发送此标头,如下所示:
curl --location 'https://li.quest/v1/quote?fromChain=100&fromAmount=1000000&fromToken=0x4ecaba5870353805a9f068101a40e0f32ed605c6&fromAddress=0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0&toChain=137&toToken=0x2791bca1f2de4661ed88a30c99a7a9449aa84174&slippage=0.03' \
--header 'x-lifi-api-key: YOUR_CUSTOM_KEY'
可以使用以下端点测试 API 密钥:
curl --location 'https://li.quest/v1/keys/test' 
--header 'x-lifi-api-key: YOUR_CUSTOM_KEY'
永远不要在客户端环境中暴露您的 x-lifi-api-key,例如基于浏览器的 JavaScript 或直接的小部件集成。在客户端使用 API 密钥可能导致未经授权的使用或滥用您的密钥,因为它会在浏览器的开发者工具或网络标签中公开可见。 如果您使用 LI.FI 小部件,您不需要传递 API 密钥。小部件在前端安全运行,无需密钥。对于服务器端集成(例如 SDK 或来自后端的 API 请求),请始终保持您的密钥机密和安全。

速率限制

速率限制在没有 API 密钥的情况下按 IP 计算,在有 API 密钥的认证请求中按 API 密钥计算。 请参考速率限制和 API 身份验证页面。

错误消息

错误由三部分组成:
  1. HTTP 错误代码
  2. LI.FI 错误代码
  3. 错误消息
具体的错误代码和消息在错误代码页面中定义
I