WANLAN Developer
WANLAN Developer
API 接入说明、Webhook 事件投递与开放平台入口。
完整 API 参考文档正在建设中。以下条目均对应平台现有可用接口，可直接用于联调。
基础信息
API 基址
https://api.wan-wan.top
认证方式
账号密码换取访问令牌后，以 Authorization: Bearer <token> 调用受保护接口。
数据隔离
所有业务接口按账号所属主体隔离，只能访问自身数据。
健康检查
GET /health — 返回服务运行状态与时间戳，可用于探活。
平台现有接口（可直接联调）
| 方法 | 路径 | 用途 |
|---|---|---|
| POST | /auth/login | 登录并获取访问令牌 |
| POST | /auth/register | 注册商家账号 |
| POST | /agent/ask | 商家 AI Agent 经营问答（只读查询） |
| POST | /widget/chat | 买家侧 AI 客服对话 |
| GET | /widget/history | 查询会话历史 |
| GET | /handoff/pending | 待人工处理的会话列表 |
| GET | /handoff/pending-count | 待人工处理的会话数量 |
| GET | /health | 服务健康检查 |
事件与 Webhook
渠道事件通过 Webhook 投递到平台，平台侧完成签名验签、幂等去重与防重放处理。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET / POST | /webhook/taobao | 淘宝（千牛）Webhook 验证与接收 |
| POST | /connections/woocommerce/<connectionId>/webhook | WooCommerce 事件投递（HMAC 验签） |
| POST | /xiaohongshu/webhook | 小红书事件接收 |
| POST | /douyin/webhook/<accountId> | 抖音事件接收 |
专用接入入口：webhook.wan-wan.top 事件说明：events.wan-wan.top