房产经纪人智能体 · 按《系统开发文档 V1.2》第 4 / 7 / 8 / 9 章实现的多租户服务端骨架
独立子域发布 · HTTPS · 与 H5 演示站及 WorkBuddy 演示端数据零污染
| 路径 | 说明 |
|---|---|
GET /healthz | 健康检查,返回演示标识、试用天数、演示号与演示码 |
POST /api/v1/auth/sms | 演示态仅放行白名单手机号,不回显任何动态验证码 |
POST /api/v1/auth/login | 固定演示码登录,首次登录自动建租户并返回 Bearer 令牌 |
GET /api/v1/tenant/me | 租户视图与「免费试用 15 天」账号口径 |
GET / POST /api/v1/leads | 线索列表 / 新建,租户身份只取自令牌 |
PUT /api/v1/plugins/:id/perms | 权限白名单;自动发送类权限服务端恒为 false |
POST /api/v1/content/listing | 房源文案合规改写与留痕 |
POST /api/v1/demo/binding | 演示态:为当前租户生成可验签的回调绑定(幂等) |
POST /hook/:tail4/:plugin | 来客回调:签名反查租户 + event_id 幂等 → 线索入池 |
# 1. 健康检查 curl https://api.menpai.enable.ren/healthz # 2. 发送验证码(演示态不回显码) curl -X POST https://api.menpai.enable.ren/api/v1/auth/sms \ -H 'Content-Type: application/json' \ -d '{"phone":"13800006688"}' # 3. 固定演示码登录,取 token curl -X POST https://api.menpai.enable.ren/api/v1/auth/login \ -H 'Content-Type: application/json' \ -d '{"phone":"13800006688","code":"668866","agree":true}' # 4. 带令牌查看账号与线索 curl https://api.menpai.enable.ren/api/v1/tenant/me \ -H 'Authorization: Bearer <token>'
X-Signature = hex( HMAC-SHA256( secret, X-Timestamp + "." + rawBody ) ) Content-Type 必须为 application/json; charset=utf-8 X-Timestamp 与服务端时间差 ≤ 300 秒;X-Nonce 长度 8~32 同尾号候选绑定逐个验签,恰好 1 个通过才归属,≥2 个直接拒绝