客临门 API - 开发者文档

快速开始

客临门 API 提供 RESTful 接口，支持线索管理、客户评分、渠道对接、会员管理等核心功能。

Base URL: https://api.kelinmen.com/api/v1

认证方式

所有 API 请求需要在 Header 中携带 JWT Token：

Authorization: Bearer <your_access_token>
X-Tenant-Id: <your_tenant_id>
X-Platform: WEB_PC | APP_ANDROID | APP_IOS | MP_WECHAT | MP_DOUYIN | MP_ALIPAY

核心接口

认证相关

POST /api/v1/auth/login

用户登录，获取 access_token 和 refresh_token

POST /api/v1/auth/register

企业注册，创建租户和管理员账号

POST /api/v1/auth/refresh

刷新 access_token

线索管理

GET /api/v1/leads

获取线索列表（支持分页、筛选、排序）

GET /api/v1/leads/{id}

获取线索详情

POST /api/v1/leads

创建线索（手动录入）

PUT /api/v1/leads/{id}/status

更新线索状态（审核、分配、触达、转化等）

AI 评分

POST /api/v1/scoring/score

触发 AI 评分（3层评分引擎：拟合度、意向度、可执行性）

GET /api/v1/scoring/{leadId}/result

获取评分结果和证据链

渠道对接

GET /api/v1/channels

获取已接入渠道列表

POST /api/v1/channels

注册新渠道适配器

POST /api/v1/webhooks/{channel}

接收渠道 Webhook 推送

会员中心

GET /api/v1/membership

获取会员信息（套餐、用量、权益）

GET /api/v1/membership/plans

获取可订阅套餐列表

POST /api/v1/payment/subscribe

订阅/升级套餐

支持渠道

抖音 - 企业号私信、直播间互动、短视频评论
小红书 - 企业号私信、笔记评论、聚光平台
快手 - 企业号私信、直播间互动、磁力引擎
官网 - 表单提交、在线客服、埋点追踪
线下 - 活动二维码、名片扫描、展会签到

技术规格

协议: HTTPS (TLS 1.2+)
格式: JSON (UTF-8)
认证: JWT Bearer Token
限流: 100次/分钟（标准版），1000次/分钟（专业版），不限（企业版）
版本: v1（当前）

合规提醒：所有线索数据需符合《个人信息保护法》要求，字段采集采用白名单机制，敏感信息需加密存储和传输。

示例请求

curl -X GET "https://api.kelinmen.com/api/v1/leads?page=1&size=20" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "X-Tenant-Id: tenant_abc123" \
  -H "X-Platform: WEB_PC"

响应示例

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "L20260301001",
        "grade": "A",
        "totalScore": 92,
        "status": "pending_review",
        "platform": "douyin",
        "summary": "某连锁餐饮品牌市场部负责人...",
        "createdAt": 1709251200000
      }
    ],
    "total": 156,
    "page": 1,
    "size": 20
  }
}