xiangqinxiangmu/LiangZhiYUMao/天行数据API配置指南.md

🌟 天行数据API配置指南

📋 问题现象

当使用星座运势功能时，控制台显示：

⚠️ API Key未正确配置，使用本地数据

🔧 解决方案

1. 注册天行数据账号

访问 天行数据官网 注册账号。

2. 申请星座运势接口

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

3. 获取API Key

1. 进入 控制台
2. 复制你的专属API Key

4. 配置API Key

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

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星座运势数据

📊 接口参数说明

根据 官方文档：

参数名	类型	必须	说明	示例值
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调用失败，系统也会自动使用本地数据保证功能可用：

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

🚀 完整测试流程

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

📞 技术支持

如果仍有问题，可以：

1. 查看 天行数据帮助文档
2. 联系天行数据客服
3. 检查网络连接和防火墙设置

---

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