LINGLI / 开发者文档
使用服务端密钥访问伶俐数据 API
在服务端保存伶俐 API 密钥，使用 X-API-Key 请求头调用对应接口，了解上线前的密钥检查与泄露处理原则。
伶俐数据 · 更新于 2026年10月9日
伶俐公开接入示例使用 X-API-Key 请求头。你需要在用户中心创建自己的密钥，并在服务端发起对应接口请求。
密钥的保存位置
将密钥放在服务端环境变量或适合自身部署方式的凭据管理系统中。应用启动时读取配置，再在请求头中传递。前端页面只与自己的后端交互，不将真实密钥发送给浏览器。
本项目公开示例使用 LINGLI_API_KEY 作为环境变量名称。它是应用配置名称，接口鉴权仍使用 X-API-Key 请求头。
上线前检查
- 检查代码仓库和构建产物，确认没有真实密钥。
- 检查日志、报错、监控和截图，避免输出完整请求头。
- 核对实际请求域名与接口路径，不根据当前网页域名拼接 API 地址。
- 确认只有需要执行调用的服务能够读取凭据。
具体密钥状态、可用权限及接口要求，以用户中心和对应文档为准。
发现泄露后的处理
停止继续传播包含密钥的文件或日志，并通过用户中心可用的管理功能处理原凭据。检查可能受影响的调用记录，更新服务端配置，再验证新配置。
在公开仓库中删除一行密钥不会自动消除历史泄露风险。若无法确定管理操作，应先联系服务方确认处理方式。
控制台与服务端调用
控制台登录用于账户与接口管理。服务端调用使用自己配置的 API 密钥。接入程序应遵循接口文档，不复制浏览器登录会话作为公开 API 鉴权方案。