# 🌟 天行数据API配置指南

## 📋 问题现象

当使用星座运势功能时，控制台显示：
```
⚠️ API Key未正确配置，使用本地数据
```

## 🔧 解决方案

### 1. 注册天行数据账号

访问 [天行数据官网](https://www.tianapi.com) 注册账号。

### 2. 申请星座运势接口

1. **登录后访问**: [星座运势接口页面](https://www.tianapi.com/apiview/78)
2. **点击"申请接口"**
3. **接口信息**:
   - **接口地址**: `https://apis.tianapi.com/star/index`
   - **请求方式**: `GET/POST`
   - **免费额度**: 普通会员每天100次

### 3. 获取API Key

1. 进入 [控制台](https://www.tianapi.com/console/)
2. 复制你的专属API Key

### 4. 配置API Key

打开文件 `LiangZhiYUMao/config/api-config.js`，修改：

```javascript
export const TIANAPI_CONFIG = {
	// 将下面的示例Key替换为你的真实Key
	API_KEY: '你的真实API_KEY_在这里', // ⚠️ 替换这里
	
	BASE_URL: 'https://apis.tianapi.com',
	ENDPOINTS: {
		constellation: '/star/index',     // 星座运势
		// ... 其他配置
	}
}
```

### 5. 测试验证

重新运行项目，选择星座查看运势，控制台应该显示：

```
🔍 尝试调用天行数据星座运势API
📡 API请求地址: https://apis.tianapi.com/star/index
✅ 成功获取API星座运势数据
```

## 📊 接口参数说明

根据 [官方文档](https://www.tianapi.com/apiview/78)：

| 参数名 | 类型   | 必须 | 说明 | 示例值 |
|--------|--------|------|------|--------|
| key    | string | 是   | API密钥 | 你的API_KEY |
| astro  | string | 是   | 星座英文名 | taurus |
| date   | string | 否   | 日期 | 2024-10-13 |

## 📚 十二星座英文对照

| 中文 | 英文 | 符号 |
|------|------|------|
| 白羊座 | aries | ♈ |
| 金牛座 | taurus | ♉ |
| 双子座 | gemini | ♊ |
| 巨蟹座 | cancer | ♋ |
| 狮子座 | leo | ♌ |
| 处女座 | virgo | ♍ |
| 天秤座 | libra | ♎ |
| 天蝎座 | scorpio | ♏ |
| 射手座 | sagittarius | ♐ |
| 摩羯座 | capricorn | ♑ |
| 水瓶座 | aquarius | ♒ |
| 双鱼座 | pisces | ♓ |

## 💰 接口价格

| 用户等级 | 每日调用量 | 价格 |
|----------|------------|------|
| 普通会员 | 100次 | 免费 |
| 高级会员 | 1万次 | 20元/月 |
| 黄金会员 | 50万次 | 65元/月 |

## 🛠️ 错误处理

### 常见错误码

| 错误码 | 错误信息 | 解决方案 |
|--------|----------|----------|
| 150 | API可用次数不足 | 升级会员或等待次日重置 |
| 160 | 账号未申请该API | 先申请星座运势接口 |
| 230 | key错误或为空 | 检查API_KEY是否正确 |
| 250 | 数据返回为空 | 检查星座参数是否正确 |

### 降级机制

即使API调用失败，系统也会自动使用本地数据保证功能可用：

```javascript
// API失败时自动降级
if (!apiResult) {
    console.log('🔄 API调用失败，使用本地星座数据')
    return generateLocalConstellationFortune(constellation)
}
```

## 🚀 完整测试流程

1. **配置API Key**
2. **重启项目**
3. **进入星座卡片功能**
4. **选择生日日期**
5. **查看控制台输出**
6. **验证运势数据来源**

## 📞 技术支持

如果仍有问题，可以：

1. 查看 [天行数据帮助文档](https://www.tianapi.com/help)
2. 联系天行数据客服
3. 检查网络连接和防火墙设置

---

**✨ 配置完成后，你的星座运势功能将使用专业的API数据，提供更准确的运势信息！**
