轻悦命名 开发者接口
本站以 HTTPS 提供 JSON 接口。以下为当前对外开放的端点说明与调用示例，全部参数与响应均以线上实际行为为准。
当前开放范围
为避免误导，先说明现状：
✅ 公共只读端点
无需鉴权即可调用，返回公开数据（服务状态、公开配置、公开统计、博客与评价）。适合展示类集成与站点监控。
🔒 账户端点
依赖于浏览器登录态（HttpOnly Cookie），仅面向本站前端使用，暂不对外开放调用。
🚧 API Key 体系
面向第三方的密钥鉴权与配额体系尚在规划中。如有商业集成需求，请先通过邮件与我们联系洽谈。
重要：本站接口为产品自身前端所使用，未承诺稳定性 SLA，字段与路径可能随版本调整。请勿在生产环境中将其作为关键依赖；如需稳定接口，请与我们联系获取专项方案。
快速开始
所有请求返回 application/json。以下示例可直接复制执行。
# 1) 服务健康检查
curl -s https://qingyueqiming.cn/health
# 2) 获取公开配置（应用名、价格表、支付模式）
curl -s https://qingyueqiming.cn/api/config
# 3) 获取公开统计
curl -s https://qingyueqiming.cn/api/track/public-stats
实测响应示例：
// GET /health
{"ok":true,"ts":1791722363906}
// GET /api/config
{"appName":"轻悦命名",
"prices":{"premium":39.9,"rename":29.9,"pet":49.9,"novel":4.9,"game":2.9,"brand":99.9},
"currency":"CNY","payProvider":"mock", ...}
// GET /api/track/public-stats
{"visits":13,"bazi":0,"scored":0,"paid":0}
说明：
payProvider 为 "mock" 表示当前处于演示支付模式。正式上线后将切换为真实支付通道，该字段取值会随之变化，请勿据此做业务假设。
公共只读端点无需鉴权
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /health | 服务健康检查，返回 {"ok":true,"ts":时间戳} |
| GET | /api/config | 公开配置：应用名、价格表、币种、支付模式、超时与轮询参数 |
| GET | /api/data | 评分权重配置与 A/B 实验配置 |
| GET | /api/track/public-stats | 公开统计：访问量、排盘数、评分数、付费数 |
| GET | /api/track/testimonials | 公开评价列表 {"items":[...]} |
| GET | /api/blog | 博客文章列表 {"posts":[...]} |
| GET | /api/blog/:slug | 按 slug 获取单篇文章 |
账户端点需浏览器登录态
这些端点依赖 HttpOnly Cookie 中的登录会话，仅服务本站自身前端，当前不对外开放。列出仅供了解系统结构。
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/auth/register | 注册账户 |
| POST | /api/auth/login | 登录，成功后下发会话 Cookie |
| POST | /api/auth/logout | 退出登录 |
| GET | /api/auth/me | 获取当前登录用户 |
| POST | /api/auth/forgot | 请求密码重置 |
| POST | /api/auth/reset | 执行密码重置 |
| POST | /api/history/save | 保存起名记录（出生信息加密存储） |
| GET | /api/history/list | 起名记录列表 |
| GET | /api/history/:id | 获取单条记录 |
| DEL | /api/history/:id | 删除单条记录 |
| DEL | /api/history/all | 清空全部记录 |
| POST | /api/referral/generate | 生成个人推荐码 |
| POST | /api/referral/claim | 兑换他人推荐码 |
支付与订单需浏览器登录态
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/pay/create | 创建支付订单，返回订单号与支付参数 |
| GET | /api/pay/status/:no | 按订单号查询支付状态 |
| GET | /api/pay/stream | 订单状态推送（Server-Sent Events） |
| GET | /api/pay/orders | 当前用户的订单列表 |
| POST | /api/pay/refund | 提交退款申请 |
| GET | /api/pay/cert/verify | 报告证书验真 |
| POST | /api/pay/wechat/notify | 微信支付结果回调（供支付平台调用） |
数据上报
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/track/event | 上报前端行为事件 |
| POST | /api/track/error | 上报前端运行时错误 |
| POST | /api/track/lead | 提交留资信息 |
| GET | /api/track/funnel | 转化漏斗数据 |
约定
响应格式
成功返回 application/json。错误返回形如 {"error":"not_found"} 的 JSON 对象，并配合相应的 HTTP 状态码（如 404、429）。
速率限制
/api 前缀下的请求受速率限制保护，超出阈值将返回 429。请勿高频轮询，建议对只读数据做本地缓存。
跨域（CORS）
默认不开启跨域访问。浏览器环境下的跨源调用会被拒绝；服务端到服务端的调用不受此限制。
时区与时间
时间戳统一为 Unix 毫秒（如 ts 字段）。排盘相关的真太阳时校正在服务端按出生地经度处理。
需要稳定接口或商业集成？
API Key 鉴权、配额与稳定性保障方案正在规划中。有合作意向请邮件联系，说明用途与预估调用量。
邮件联系我们