开发文档

完整的 API 接口手册与 AI 平台接入指南


概述

请求方式

POST(JSON Body)

基础路径

/api/v1/

跨域支持

CORS 已启用

统一响应格式

{ "ok": true, "data": { ... } }
{ "ok": false, "error": "错误描述" }

全部端点

注意事项

  • 所有时间参数均基于公历,hour 为 24 小时制 (0-23)
  • 分析类字段(analysis、interpretation)采用宽容策略:计算失败时返回 null,不影响主结果
  • API 计算结果与网页前端完全一致,共用同一套计算引擎
  • HTTP 状态码:200 成功 / 400 参数错误 / 500 计算异常