# API文档

本目录包含GEO平台的API接口文档。

## 文档内容

- [认证API](./auth.md) - 用户认证相关接口
- [品牌API](./brands.md) - 品牌管理接口
- [内容API](./content.md) - 内容生成接口
- [知识库API](./knowledge.md) - 知识库接口
- [诊断API](./diagnosis.md) - SEO/GEO诊断接口 ✅ 新增
- [健康检查](./health.md) - 系统健康检查接口

## 诊断模块API

诊断模块提供3个核心端点：

| 端点 | 描述 | 状态 |
|------|------|------|
| `GET /api/v1/diagnosis/seo/{brand_id}` | 获取品牌的SEO诊断结果 | ✅ 已完成 |
| `GET /api/v1/diagnosis/geo/{brand_id}` | 获取品牌的GEO诊断结果 | ✅ 已完成 |
| `GET /api/v1/diagnosis/combined/{brand_id}` | 获取品牌的SEO+GEO综合诊断结果 | ✅ 已完成 |

详细说明请查看 [诊断模块说明](../02-模块说明/diagnosis.md)。

## API基础信息

- 基础URL: `http://localhost:8000`
- API版本: `v1`
- 认证方式: Bearer Token (JWT)
- 响应格式: JSON

## 通用响应格式

```json
{
  "success": true,
  "data": {},
  "message": "操作成功",
  "error": null
}
```

## 错误响应

```json
{
  "success": false,
  "data": null,
  "message": "错误描述",
  "error": {
    "code": "ERROR_CODE",
    "details": {}
  }
}
```

## 认证

除健康检查外，所有API都需要认证：

```bash
curl -H "Authorization: Bearer <token>" http://localhost:8000/api/v1/...
```
