天行数据API接入指南 🚀

✅ 已完成的准备工作

我已经为你完成了所有代码准备工作：

✅ 创建了API配置文件
✅ 编写了API调用代码
✅ 添加了错误处理和降级机制
✅ 修改了属相测试页面

现在你只需要3个步骤，5分钟完成接入！

📋 你需要做的事（只需3步）

第一步：注册天行数据账号

打开浏览器，访问天行数据官网
```
https://www.tianapi.com/
```
点击右上角"注册"按钮
- 使用手机号或邮箱注册
- 填写基本信息
- 完成验证
登录后，进入控制台
- 点击顶部导航"控制台"
- 进入个人中心

第二步：获取API Key

在控制台找到"API Key"
- 左侧菜单 → "API管理" → "API Key"
- 或者直接访问：https://www.tianapi.com/console/
复制你的API Key
```
示例格式：a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
```
⚠️ 注意：这个Key很重要，请妥善保管！
开通生肖运势API（免费）
- 返回首页，点击"API商店"
- 搜索"生肖"或"十二生肖"
- 找到"十二生肖运势查询"API
- 点击"免费试用"按钮
- 确认开通（每天100次免费额度）

第三步：配置API Key到项目中

打开配置文件

文件路径：LiangZhiYUMao/config/api-config.js

找到第8行，替换API Key

修改前：

   API_KEY: 'YOUR_API_KEY_HERE', // ⚠️ 请替换为你的真实Key

修改后：

   API_KEY: 'a1b2c3d4e5f6g7h8i9j0', // 替换为你刚才复制的Key

保存文件
- 按 Ctrl + S 保存
- 重启开发服务器（如果正在运行）

✅ 验证是否配置成功

方法1：查看控制台

运行项目后，打开浏览器控制台（F12），应该不会看到这个警告：

⚠️ 警告：请先配置天行数据API Key！

方法2：测试功能

进入属相测试页面
选择生日
点击"开始测算"
查看测算结果页面

如果配置成功：

数据来源显示：✓ 天行数据专业API（绿色背景）
运势数据是实时从API获取的

如果配置失败：

数据来源显示：ℹ️ 传统生肖文化理论（蓝色背景）
或者显示：本地数据（API暂不可用）

🎨 效果对比

配置前（本地数据）

数据来源：传统生肖文化理论
今日运势：较好
爱情运：75%（随机生成）

配置后（API数据）

✓ 数据来源：天行数据专业API
更新时间：2025年10月13日 14:30:25
今日运势：较旺（来自专业API）
爱情运：88%（根据实际分析）
幸运颜色：红色
幸运数字：6

📊 API使用额度说明

免费额度

每天100次免费调用
对于初期使用完全够用

使用量估算

假设你的平台：

每天10个用户测试属相
每次测试调用1次API
每天只用10次，远低于100次上限

如果超出免费额度

可以升级付费套餐
价格：约0.005元/次（非常便宜）
月费套餐：30元/月（约6000次）

🔧 常见问题

Q1: API Key填错了怎么办？

A: 重新打开 config/api-config.js，修改第8行，保存后刷新页面。

Q2: 显示"API调用失败"

A: 可能的原因：

API Key未开通生肖运势API → 去官网开通
网络问题 → 检查网络连接
超出免费额度 → 查看控制台使用量

系统会自动降级到本地数据，不影响用户使用。

Q3: 如何查看API调用次数？

A: 登录天行数据控制台 → "API管理" → "调用统计"

Q4: 不想用API了，怎么关闭？

A: 方法1：删除 config/api-config.js 中的API Key 方法2：在 zodiac.vue 中注释掉 zodiacEnhanced 的引用

📞 获取帮助

天行数据官方支持

官网：https://www.tianapi.com/
文档：https://www.tianapi.com/apiview/
客服：在线客服（工作时间回复）

API文档

接口地址：https://apis.tianapi.com/shengxiao/index
请求方式：GET
必填参数：
  - key: 你的API Key
  - name: 生肖名称（如：鼠、牛、虎等）

🎯 完成后的收益

✅ 权威性提升：从娱乐级别 → 专业级别 ✅ 用户信任：显示"专业API"数据来源 ✅ 数据准确：每日更新的真实运势数据 ✅ 零成本：免费额度完全够用 ✅ 自动降级：API失败时自动使用本地数据

📝 操作检查清单

完成后请勾选：

已注册天行数据账号
已获取API Key
已开通"生肖运势"API
已在 config/api-config.js 中配置API Key
已测试功能，确认显示"天行数据专业API"

全部勾选完成？恭喜你！🎉 API接入成功！

🚀 下一步扩展

接入成功后，你还可以：

✅ 接入星座运势API（代码已准备好）
✅ 接入农历查询API
✅ 添加更多测算功能
✅ 开发付费咨询服务

需要帮助随时找我！😊

天行数据API接入指南.md 5.1 KB Permalink Cronologia Originale