API Docs
官网链路对应的核心接口。
前台页面和自动化流程都基于这些接口完成注册、开通、下载、API Key 管理与 AI 业务结果回传。
| 接口 | 用途 |
|---|---|
| POST /api/auth/register | 注册账号并创建业务主体 |
| POST /api/auth/login | 登录并获取 JWT |
| GET /api/billing/wallet | 查看钱包余额 |
| POST /api/billing/charge | 创建真实充值订单 |
| GET /api/billing/charge/{id} | 读取单笔充值单状态与支付凭证信息 |
| POST /api/billing/charge/{id}/simulate-success | 显式开启本地联调开关后完成支付成功回写，仅用于联调与回归 |
| POST /api/billing/compute-units/purchase | 环境内即时购买额度 |
| GET /api/keys | 列出 API Key |
| POST /api/keys | 创建 API Key |
| POST /v1/factors/calculate | 统一研究执行入口，按 factor / symbols / params / timeframe 计算结果 |
| POST /v1/chat/conversations/{id}/messages | 发送问题并返回业务分析结果 |
认证规范：Web 页面使用 JWT；服务端直接调用默认推荐使用X-API-Key请求头，同时兼容Authorization: Bearer形式。
接口基线：研究能力统一收敛到 `POST /v1/factors/calculate`，不再把前台集成说明拆成 `/v1/factors/momentum`、`/v1/factors/value`、`/v1/factors/volatility` 这类旧路径。
联调说明：`POST /api/billing/charge/{id}/simulate-success` 仅在同时满足 `ENABLE_LOCAL_PAYMENT_CALLBACK=true`、`APP_ENV!=production`、`DEBUG=true` 且 `NEXTAUTH_URL` 指向 `localhost` / `127.0.0.1` 时可用。生产链路仍应以第三方支付平台真实回调为准。