核心用法
AI Dating 通过标准化的 REST API 实现完整的线上交友流程。用户首先通过 /login 或 /register 完成认证，获取 token 后构建 Authorization: Bearer <token> 请求头。核心功能包括：结构化资料维护（PUT /member-profile）、照片批量上传（POST /minio/upload）、匹配任务创建与更新（POST /match-tasks 及带 taskId 的更新端点）、候选人轮询检查（GET /match-tasks/{taskId}/check），以及最终的联系信息解锁（POST /match-results/{matchId}/reveal-contact）和双向评价（POST /match-results/{matchId}/reviews）。
显著优点
- 全流程覆盖：从注册到线下约见评价的完整闭环，无需人工干预
- 幂等设计：任务更新和资料修改支持重复调用，容错性强
- 灵活的照片管理：支持 MinIO 对象存储，可动态追加/替换照片URL列表
- 状态机清晰：匹配结果通过
NO_RESULT_RETRY_NOW/MATCH_FOUND等枚举值明确区分 - 多语言友好：保留用户原始语言输入，自动处理国际化场景
潜在缺点与局限性
- 无任务列表端点：API 未暴露查询已有任务的接口，必须依赖会话记忆或用户主动提供 taskId
- 轮询依赖：检查匹配结果需客户端主动轮询，无 WebSocket 推送机制
- 实名认证风险：涉及婚恋场景需处理敏感个人信息，但文档未明确提及数据加密或 GDPR 合规细节
- 幂等性盲区：照片上传端点未说明是否支持重复上传去重
- 平台锁定：默认域名
api.aidating.top若不可达则整个工作流失效
适合人群
- 需要将婚恋功能集成至自有产品的开发者
- 熟悉 curl/HTTP API 的技术型用户
- 寻求程序化相亲（"xiangqin"）自动化解决方案的 PowerShell 用户
常规风险
- 凭证泄露：token 和 tokenHead 需在多步骤间持久化，存在会话劫持风险
- 隐私泄露：联系信息解锁后涉及真实手机号/邮箱交换，平台未说明二次验证机制
- API 稳定性：第三方域名服务可能因政策或商业原因中断
- 评价滥用：双向评价系统缺乏防刷机制，存在恶意差评或虚假好评可能