C API 文档 + 示例

提示:后续新增的 API 接口都会在此页面补充调用示例。

健康检查

curl -i https://你的域名/api/health

英文聊天(1-2句)

curl -X POST https://你的域名/api/chat/en \
  -H "Content-Type: application/json" \
  -d '{
    "my_nick":"my_account",
    "peer_nick":"peer_user",
    "persona_id":"1",
    "message_history":[
      {"role":"user","content":"Hey"},
      {"role":"assistant","content":"Hi 😊 How’s your day going?"}
    ]
  }'

响应里你应该关注

{
  "reply": "....",
  "session_id": "...",
  "ended": false,
  "end_reason": ""
}

检查 UID 是否重复(不存在则自动入库)

curl -X POST https://你的域名/api/leads/check_or_add \
  -H "Content-Type: application/json" \
  -d '{
    "uid":"6980795100092138502"
  }'
{
  "success": true,
  "status": "duplicate",
  "message": "重复"
}

{ 
  "success": true,
  "status": "new",
  "message": "未重复"
}

主动回复候选(按最后回复时间筛选,返回一行一条)

curl -X POST https://你的域名/api/sessions/followup \
  -H "Content-Type: application/json" \
  -d '{
    "idle_seconds": 3600,
    "limit": 20
  }'
{"uid":"...","my_nick":"my_account","peer_nick":"peer_user","reply":"...","delay_seconds":3,"ended":false,"success":true}
{"uid":"...","my_nick":"my_account","peer_nick":"peer_user","reply":"...","delay_seconds":2,"ended":false,"success":true}

主动回复候选(JSON 格式)

curl -X POST https://你的域名/api/sessions/followup \
  -H "Content-Type: application/json" \
  -d '{
    "idle_seconds": 3600,
    "limit": 20,
    "format": "json"
  }'
{
  "success": true,
  "count": 2,
  "items": [
    {"uid":"...","my_nick":"my_account","peer_nick":"peer_user","reply":"...","delay_seconds":3,"ended":false,"success":true}
  ]
}

← 返回后台首页