JuAI API Overview

1.1 产品简介

JuAI API 为 Ju 平台提供智能问答、热点聚合、运营审计、知识库统计等能力。

1.2 适用场景

• 前台 App / Web 聊天问答
• 热点新闻与话题聚合
• 后台运营分析与质检
• 平台积分与免费额度联动（部分已实现）

1.3 环境说明

• Local: http://127.0.0.1:8100
• Staging: https://api.juai.store
• Production: 预留

1.4 Base URL

• Public API: https://api.juai.store
• Internal Admin API: https://api.juai.store/api/v1/admin/...（仅内部）

1.5 返回格式约定

大多数接口使用统一响应：

{
  "success": true,
  "code": 0,
  "message": "ok",
  "data": {},
  "request_id": "uuid"
}

1.6 时间与时区说明

• 时间字段默认 ISO8601（UTC）格式。
• 积分/免费次数重置口径在业务说明层按 UTC+8 表达。

1.7 版本说明

• 当前文档草案版本：v0.7.0-staging-docs-draft.1
• OpenAPI 来源：运行时 FastAPI 实际导出（非手写）

文档可见性

• public/*：可对外发布
• internal/*：仅内部运营/开发可见，不对外公开