mirror of
https://github.com/patdelphi/suanming.git
synced 2026-03-06 08:33:11 +08:00
441 lines
9.4 KiB
Markdown
441 lines
9.4 KiB
Markdown
# API 文档
|
||
|
||
本文档描述了三算命平台的后端API接口，所有API都基于Supabase Edge Functions实现。
|
||
|
||
## 基础信息
|
||
|
||
- **Base URL**: `https://your-project.supabase.co/functions/v1`
|
||
- **认证方式**: Bearer Token (Supabase JWT)
|
||
- **数据格式**: JSON
|
||
- **字符编码**: UTF-8
|
||
|
||
## 通用响应格式
|
||
|
||
### 成功响应
|
||
```json
|
||
{
|
||
"data": {
|
||
"record_id": "uuid",
|
||
"analysis": {
|
||
// 分析结果数据
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### 错误响应
|
||
```json
|
||
{
|
||
"error": {
|
||
"code": "ERROR_CODE",
|
||
"message": "错误描述信息"
|
||
}
|
||
}
|
||
```
|
||
|
||
## 认证
|
||
|
||
所有API请求都需要在请求头中包含认证信息：
|
||
|
||
```http
|
||
Authorization: Bearer <your-jwt-token>
|
||
Content-Type: application/json
|
||
```
|
||
|
||
## API 接口
|
||
|
||
### 1. 八字命理分析
|
||
|
||
**接口地址**: `POST /bazi-analyzer`
|
||
|
||
**请求参数**:
|
||
```json
|
||
{
|
||
"user_id": "string",
|
||
"birth_data": {
|
||
"name": "string",
|
||
"birth_date": "YYYY-MM-DD",
|
||
"birth_time": "HH:MM",
|
||
"gender": "male|female",
|
||
"birth_place": "string"
|
||
}
|
||
}
|
||
```
|
||
|
||
**响应示例**:
|
||
```json
|
||
{
|
||
"data": {
|
||
"record_id": "123e4567-e89b-12d3-a456-426614174000",
|
||
"analysis": {
|
||
"bazi": {
|
||
"year": "甲子",
|
||
"month": "丙寅",
|
||
"day": "戊辰",
|
||
"hour": "庚申"
|
||
},
|
||
"wuxing": {
|
||
"wood": 2,
|
||
"fire": 1,
|
||
"earth": 2,
|
||
"metal": 2,
|
||
"water": 1
|
||
},
|
||
"analysis": {
|
||
"character": "性格分析内容",
|
||
"career": "事业分析内容",
|
||
"wealth": "财运分析内容",
|
||
"health": "健康分析内容",
|
||
"relationships": "感情分析内容"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### 2. 紫微斗数分析
|
||
|
||
**接口地址**: `POST /ziwei-analyzer`
|
||
|
||
**请求参数**:
|
||
```json
|
||
{
|
||
"user_id": "string",
|
||
"birth_data": {
|
||
"name": "string",
|
||
"birth_date": "YYYY-MM-DD",
|
||
"birth_time": "HH:MM",
|
||
"gender": "male|female",
|
||
"birth_place": "string"
|
||
}
|
||
}
|
||
```
|
||
|
||
**响应示例**:
|
||
```json
|
||
{
|
||
"data": {
|
||
"record_id": "123e4567-e89b-12d3-a456-426614174000",
|
||
"analysis": {
|
||
"ziwei": {
|
||
"ming_gong": "子",
|
||
"ming_gong_xing": ["紫微", "天机"],
|
||
"shi_er_gong": {
|
||
"命宫": {
|
||
"branch": "子",
|
||
"main_stars": ["紫微", "天机"],
|
||
"interpretation": "命宫解读内容"
|
||
}
|
||
// ... 其他宫位
|
||
},
|
||
"si_hua": {
|
||
"hua_lu": {
|
||
"star": "廉贞",
|
||
"meaning": "财禄亨通，运势顺遂"
|
||
},
|
||
"hua_quan": {
|
||
"star": "破军",
|
||
"meaning": "权力地位，事业有成"
|
||
},
|
||
"hua_ke": {
|
||
"star": "武曲",
|
||
"meaning": "贵人相助，学业有成"
|
||
},
|
||
"hua_ji": {
|
||
"star": "太阳",
|
||
"meaning": "需要谨慎，防范风险"
|
||
}
|
||
}
|
||
},
|
||
"analysis": {
|
||
"character": {
|
||
"overview": "性格概述",
|
||
"personality_traits": "性格特质"
|
||
},
|
||
"career": {
|
||
"suitable_industries": ["行业1", "行业2"],
|
||
"career_advice": "事业建议"
|
||
},
|
||
"wealth": {
|
||
"wealth_pattern": "财富模式"
|
||
},
|
||
"health": {
|
||
"constitution": "体质分析",
|
||
"wellness_advice": "健康建议"
|
||
},
|
||
"relationships": {
|
||
"marriage_fortune": "婚姻运势",
|
||
"spouse_characteristics": "伴侣特质"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### 3. 易经占卜分析
|
||
|
||
**接口地址**: `POST /yijing-analyzer`
|
||
|
||
**请求参数**:
|
||
```json
|
||
{
|
||
"user_id": "string",
|
||
"divination_data": {
|
||
"question": "string",
|
||
"method": "梅花易数时间起卦法",
|
||
"divination_time": "YYYY-MM-DDTHH:MM:SSZ"
|
||
}
|
||
}
|
||
```
|
||
|
||
**响应示例**:
|
||
```json
|
||
{
|
||
"data": {
|
||
"record_id": "123e4567-e89b-12d3-a456-426614174000",
|
||
"analysis": {
|
||
"basic_info": {
|
||
"divination_data": {
|
||
"question": "占卜问题",
|
||
"method": "梅花易数时间起卦法",
|
||
"divination_time": "2024-01-01T12:00:00Z"
|
||
},
|
||
"hexagram_info": {
|
||
"main_hexagram": "乾为天",
|
||
"hexagram_description": "卦辞内容",
|
||
"upper_trigram": "乾",
|
||
"lower_trigram": "乾",
|
||
"detailed_interpretation": "详细解释"
|
||
}
|
||
},
|
||
"detailed_analysis": {
|
||
"hexagram_analysis": {
|
||
"primary_meaning": "主要含义",
|
||
"judgment": "吉凶断语",
|
||
"image": "象辞解释"
|
||
},
|
||
"changing_lines_analysis": {
|
||
"changing_line_position": "六二",
|
||
"line_meaning": "爻辞含义"
|
||
},
|
||
"changing_hexagram": {
|
||
"name": "变卦名称",
|
||
"meaning": "变卦含义",
|
||
"transformation_insight": "变化启示"
|
||
}
|
||
},
|
||
"life_guidance": {
|
||
"overall_fortune": "整体运势",
|
||
"career_guidance": "事业指导",
|
||
"relationship_guidance": "情感指导",
|
||
"wealth_guidance": "财运指导"
|
||
},
|
||
"divination_wisdom": {
|
||
"key_message": "核心信息",
|
||
"action_advice": "行动建议",
|
||
"philosophical_insight": "哲学启示"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### 4. 五行分析
|
||
|
||
**接口地址**: `POST /bazi-wuxing-analysis`
|
||
|
||
**请求参数**:
|
||
```json
|
||
{
|
||
"user_id": "string",
|
||
"birth_data": {
|
||
"name": "string",
|
||
"birth_date": "YYYY-MM-DD",
|
||
"birth_time": "HH:MM",
|
||
"gender": "male|female"
|
||
}
|
||
}
|
||
```
|
||
|
||
**响应示例**:
|
||
```json
|
||
{
|
||
"data": {
|
||
"record_id": "123e4567-e89b-12d3-a456-426614174000",
|
||
"analysis": {
|
||
"wuxing_distribution": {
|
||
"wood": 2,
|
||
"fire": 1,
|
||
"earth": 2,
|
||
"metal": 2,
|
||
"water": 1
|
||
},
|
||
"balance_analysis": {
|
||
"dominant_element": "wood",
|
||
"lacking_element": "fire",
|
||
"balance_score": 75
|
||
},
|
||
"recommendations": {
|
||
"colors": ["红色", "橙色"],
|
||
"directions": ["南方"],
|
||
"career_fields": ["文化教育", "艺术创作"],
|
||
"lifestyle_advice": "生活建议内容"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### 5. 八字详细分析
|
||
|
||
**接口地址**: `POST /bazi-details`
|
||
|
||
**请求参数**:
|
||
```json
|
||
{
|
||
"user_id": "string",
|
||
"birth_data": {
|
||
"name": "string",
|
||
"birth_date": "YYYY-MM-DD",
|
||
"birth_time": "HH:MM",
|
||
"gender": "male|female",
|
||
"birth_place": "string"
|
||
}
|
||
}
|
||
```
|
||
|
||
**响应示例**:
|
||
```json
|
||
{
|
||
"data": {
|
||
"record_id": "123e4567-e89b-12d3-a456-426614174000",
|
||
"analysis": {
|
||
"basic_info": {
|
||
"bazi": {
|
||
"year": "甲子",
|
||
"month": "丙寅",
|
||
"day": "戊辰",
|
||
"hour": "庚申"
|
||
},
|
||
"solar_terms": "立春后",
|
||
"lunar_info": {
|
||
"lunar_date": "农历日期",
|
||
"lunar_month": "农历月份"
|
||
}
|
||
},
|
||
"detailed_analysis": {
|
||
"daymaster_analysis": "日主分析",
|
||
"pattern_analysis": "格局分析",
|
||
"useful_god": "用神分析",
|
||
"taboo_god": "忌神分析"
|
||
},
|
||
"life_stages": {
|
||
"childhood": "童年运势",
|
||
"youth": "青年运势",
|
||
"middle_age": "中年运势",
|
||
"old_age": "晚年运势"
|
||
},
|
||
"annual_fortune": [
|
||
{
|
||
"year": 2024,
|
||
"fortune": "年运分析",
|
||
"advice": "建议事项"
|
||
}
|
||
]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## 错误代码
|
||
|
||
| 错误代码 | 描述 | HTTP状态码 |
|
||
|---------|------|----------|
|
||
| INVALID_JSON | 请求JSON格式错误 | 400 |
|
||
| MISSING_PARAMETERS | 缺少必需参数 | 400 |
|
||
| INVALID_DATE_FORMAT | 日期格式错误 | 400 |
|
||
| INVALID_TIME_FORMAT | 时间格式错误 | 400 |
|
||
| UNAUTHORIZED | 未授权访问 | 401 |
|
||
| FORBIDDEN | 禁止访问 | 403 |
|
||
| ANALYSIS_ERROR | 分析过程错误 | 500 |
|
||
| DATABASE_ERROR | 数据库操作错误 | 500 |
|
||
| INTERNAL_ERROR | 内部服务器错误 | 500 |
|
||
|
||
## 使用示例
|
||
|
||
### JavaScript/TypeScript
|
||
|
||
```typescript
|
||
import { createClient } from '@supabase/supabase-js'
|
||
|
||
const supabase = createClient(
|
||
'https://your-project.supabase.co',
|
||
'your-anon-key'
|
||
)
|
||
|
||
// 八字分析示例
|
||
async function analyzeBazi(birthData: any) {
|
||
const { data, error } = await supabase.functions.invoke('bazi-analyzer', {
|
||
body: {
|
||
user_id: 'user-uuid',
|
||
birth_data: birthData
|
||
}
|
||
})
|
||
|
||
if (error) {
|
||
console.error('分析失败:', error)
|
||
return null
|
||
}
|
||
|
||
return data
|
||
}
|
||
|
||
// 使用示例
|
||
const result = await analyzeBazi({
|
||
name: '张三',
|
||
birth_date: '1990-01-01',
|
||
birth_time: '12:00',
|
||
gender: 'male',
|
||
birth_place: '北京市'
|
||
})
|
||
```
|
||
|
||
### cURL
|
||
|
||
```bash
|
||
# 八字分析
|
||
curl -X POST 'https://your-project.supabase.co/functions/v1/bazi-analyzer' \
|
||
-H 'Authorization: Bearer YOUR_JWT_TOKEN' \
|
||
-H 'Content-Type: application/json' \
|
||
-d '{
|
||
"user_id": "user-uuid",
|
||
"birth_data": {
|
||
"name": "张三",
|
||
"birth_date": "1990-01-01",
|
||
"birth_time": "12:00",
|
||
"gender": "male",
|
||
"birth_place": "北京市"
|
||
}
|
||
}'
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
1. **请求频率限制**: 每个用户每分钟最多50次请求
|
||
2. **数据格式**: 所有日期使用ISO 8601格式 (YYYY-MM-DD)
|
||
3. **时间格式**: 使用24小时制 (HH:MM)
|
||
4. **字符编码**: 所有文本数据使用UTF-8编码
|
||
5. **数据安全**: 敏感信息会被加密存储
|
||
6. **缓存策略**: 相同参数的分析结果会被缓存24小时
|
||
|
||
## 更新日志
|
||
|
||
### v1.0.0 (2024-01-01)
|
||
- 初始版本发布
|
||
- 支持八字命理、紫微斗数、易经占卜三大分析功能
|
||
- 完整的用户认证和数据存储功能
|
||
|
||
---
|
||
|
||
如有疑问或需要技术支持，请通过GitHub Issues联系我们。 |