表单收集
职责：统一收集用户提交的信息（主要是邮箱），来自不同来源页面（落地页 / 设置页 / 反馈页）。
表单收集 API
基础URL:
https://tools.wktyl.com/api/form_collect
维护: Xianyan 团队 | 更新时间: 2026-08-15
职责：统一收集用户提交的信息（主要是邮箱），来自不同来源页面（落地页 / 设置页 / 反馈页）。
1. 通用约定
- 无需登录，公开接口
- 响应
{code, msg, time, data} - 频率限制：30/60s（防刷）
- 字段：必填
source（来源标识）+email（或其他）+ 可选 metadata
2. 接口清单
| 接口 | 方法 | 说明 |
|---|---|---|
/api/form_collect/submit |
POST | 提交表单 |
/api/form_collect/list |
GET | 查询列表（管理） |
/api/form_collect/stats |
GET | 统计（按来源/时间） |
/api/form_collect/export |
GET | 导出 CSV（管理） |
/api/form_collect/blacklist |
POST | 加入黑名单 |
3. 来源标识 source
不同页面提交时自动传不同 source：
| source | 场景 |
|---|---|
landing_home |
首页落地页 |
setting_email |
设置页邮箱绑定 |
feedback |
用户反馈 |
register_suggest |
注册页邮箱推荐 |
oauth_bind |
OAuth 绑定流程 |
4. 核心示例
POST /api/form_collect/submit
Content-Type: application/json
{
"source": "landing_home",
"email": "user@example.com",
"metadata": { "page_url": "/", "ip_city": "北京" }
}
# 响应
{
"code": 1,
"msg": "已记录，感谢您的关注",
"data": { "id": 12345 }
}
5. 设计要点
- source 字段关键：区分来源便于做漏斗分析（哪个页面的转化率高）
- 黑名单机制：可拒绝已知无效邮箱（一次性、角色账号），降低无效数据
- 保留 metadata 扩展：JSON blob 灵活存任意上下文（不强制 schema）