联成

API 密钥管理

← 返回客户列表

给外部 AI 工具(Cursor / Claude / ChatGPT / n8n 等)用的接入凭证。密钥只在创建时显示一次,数据库里仅存哈希。

新建密钥

建议一个工具一把钥匙,方便单独吊销。写权限可以让 AI 回写客户资料和跟进备注。

⚠️ 这是唯一一次显示完整密钥,关闭后无法再查看(丢失请吊销重建)。

快速测试:


    

已有密钥

吊销后立即失效,对方会收到 401。

ID名称密钥权限归属调用最后调用状态

接口速查

基础地址与鉴权
Base URL : https://crm.floorltd.com
鉴权头   : Authorization: Bearer lc_xxxxxxxx
          (也支持 X-API-Key: lc_xxxxxxxx)

GET  /api/v1/ping                      连通性 + 密钥身份
GET  /api/v1/leads?country=Spain        客户列表(支持分页/筛选)
GET  /api/v1/leads/{leadId}             客户详情(含备注/状态历史)
POST /api/v1/leads                       新建或按 leadId 补字段
PATCH /api/v1/leads/{leadId}             改字段(改状态会自动记历史)
POST /api/v1/leads/{leadId}/notes         追加跟进备注
GET  /api/v1/stats                       统计
GET  /api/v1/export?format=csv           导出
GET  /api/v1/leads?updatedSince=...      增量同步(只要变动过的)

完整说明和 AI 工具配置示例见项目里的 API.md。