鉴权与密钥

所有 API 调用使用 Bearer Token 鉴权，密钥挂在组织（org）上，成员共享组织密钥池。

请求头

Authorization: Bearer lgr_live_xxxxxxxx
X-Org-Id: <可选，仅平台密钥需要>

密钥模型

属性	说明
key_prefix	密钥只存前 12 位用于展示与检索，完整密钥创建时唯一可见
scopes	逗号分隔的能力域：search read watch compute draft
expires_at	可选 ISO 8601 日期，到期自动失效
rpm / daily_cap	每分钟请求数上限 / 单日点数上限

创建与管理

密钥的创建、吊销、用量查看都在控制台完成（API 密钥 页）。管理操作不开放公开 API —— 密钥生灭必须走人工可审计的面板。

限速与错误

状态码	含义	对策
401	密钥无效或已吊销	控制台确认密钥状态
403	scope 不足	该密钥未授予对应能力域
429	触发 RPM / daily_cap	响应带 Retry-After，按秒等待

安全约定

密钥即身份。不要放在前端代码、Git 仓库或日志里；泄露后在控制台立即吊销并新建 —— 吊销是即时生效的。