跟进系统 API 说明

给 AI 助手用。只读接口，改不动数据。当前服务地址：http://yuanaoxm.chilintu.com

一、先拿 Token

登录系统 → 右上角「我的账号」→ 复制「我的 Token」。Token 与账号绑定，权限随角色：

Token 泄露可让对方看到对应范围的数据，请勿外传；怀疑泄露就在「我的账号」重置。

二、怎么调

所有请求把 token 放进请求头 X-API-Key，返回 JSON，ok 为 true 表示成功。

curl -s -H "X-API-Key: 你的token" "http://yuanaoxm.chilintu.com/api/v1/digest?days=7&format=text"

三、接口清单

路径作用
/api/v1/digest?days=7&format=text最常用：一段中文汇报（谁做了什么、谁逾期），可直接转给主管
/api/v1/summary?days=7总览：项目数、各状态计数、动作数、逾期数、重点项目数
/api/v1/team?days=7每人一行：负责数、各状态、放弃数、逾期数、最近动作时间
/api/v1/activities?days=7&user=姓名&limit=100跟进流水：时间、谁、哪个项目、改成什么状态、备注
/api/v1/projects?status=&owner=&key=1&q=&limit=100项目列表，带当前状态与跟进人
/api/v1/project/<项目ID>单个项目详情，含主管批注与全部沟通记录
/api/v1/health健康检查

四、常用问法与对应接口

主管会问调用
这周大家跟进了哪些项目？/api/v1/digest?days=7&format=text
某人这周做了什么？/api/v1/activities?days=7&user=姓名
谁的项目逾期没跟？/api/v1/team 里 overdue > 0 的
重点项目进展如何？/api/v1/projects?key=1
谁成交最多？/api/v1/team 按 won 排序

五、示例返回

近 7 天团队跟进情况：共 12 次跟进动作。
- 蒋汇泉（销售）：负责 18 个项目，近 7 天动作 5 次，已联系 4、意向 1、报价 0、成交 0、丢单 0、放弃 1，逾期未跟进 0，最近动作 2026-11-13T14:25:10

最近动作：
- 2026-11-13T14:25:10 蒋汇泉 把「大连石化搬迁改造项目」更新为 已联系，备注：已联系，客户说下个月开始交流

时间字段为服务器本地时间，格式 YYYY-MM-DDTHH:MM:SS；days=1 表示今天，7 表示近 7 天。