|
|
@@ -1,302 +0,0 @@
|
|
|
-# 🎯 极速数据八字API集成指南
|
|
|
-
|
|
|
-## 🎉 恭喜!您已成功申请极速数据八字排盘API
|
|
|
-
|
|
|
-根据您提供的接口文档,这是一个功能非常全面的专业八字排盘API!
|
|
|
-
|
|
|
-## 📋 API详细信息
|
|
|
-
|
|
|
-### 基本信息
|
|
|
-- **接口地址**: `https://api.jisuapi.com/bazi/paipan`
|
|
|
-- **请求方式**: GET / POST
|
|
|
-- **免费额度**: 申请即送10次
|
|
|
-- **付费套餐**: 980元/10000次 (≈0.098元/次)
|
|
|
-
|
|
|
-### 功能特色 ⭐⭐⭐⭐⭐
|
|
|
-- ✅ **完整八字排盘** - 年月日时四柱
|
|
|
-- ✅ **农历转换** - 自动阳历转农历
|
|
|
-- ✅ **纳音五行** - 每柱对应纳音
|
|
|
-- ✅ **节气判断** - 精确节气时间
|
|
|
-- ✅ **胎元命宫** - 专业命理要素
|
|
|
-- ✅ **神煞分析** - 详细神煞信息
|
|
|
-- ✅ **大运流年** - 运势预测
|
|
|
-- ✅ **太阳时支持** - 地理位置修正
|
|
|
-
|
|
|
-## 🔧 快速配置
|
|
|
-
|
|
|
-### 第1步:配置API Key
|
|
|
-
|
|
|
-在 `config/api-config.js` 中找到以下代码:
|
|
|
-
|
|
|
-```javascript
|
|
|
-JISU_API: {
|
|
|
- BASE_URL: 'https://api.jisuapi.com',
|
|
|
- API_KEY: 'YOUR_JISU_API_KEY', // ⚠️ 替换为您的真实API Key
|
|
|
- ENDPOINTS: {
|
|
|
- bazi: '/bazi/paipan'
|
|
|
- },
|
|
|
- // ... 其他配置
|
|
|
-}
|
|
|
-```
|
|
|
-
|
|
|
-**将 `YOUR_JISU_API_KEY` 替换为您在极速数据获取的真实API Key**
|
|
|
-
|
|
|
-### 第2步:小程序域名配置
|
|
|
-
|
|
|
-在微信小程序后台添加合法域名:
|
|
|
-```
|
|
|
-https://api.jisuapi.com
|
|
|
-```
|
|
|
-
|
|
|
-### 第3步:测试验证
|
|
|
-
|
|
|
-重新运行您的八字测算功能,控制台应该显示:
|
|
|
-```
|
|
|
-🔍 尝试调用专业八字API
|
|
|
-📡 选中API: JISU_API 专业八字排盘,功能最全面
|
|
|
-✅ JISU_API 调用成功
|
|
|
-✅ 极速数据返回完整八字排盘信息
|
|
|
-```
|
|
|
-
|
|
|
-## 📊 API参数详解
|
|
|
-
|
|
|
-### 必填参数
|
|
|
-| 参数 | 类型 | 说明 | 示例 |
|
|
|
-|------|------|------|------|
|
|
|
-| appkey | string | 您的API Key | - |
|
|
|
-| name | string | 姓名 | "张三" |
|
|
|
-| city | string | 城市 | "北京" (可空) |
|
|
|
-| year | int | 年份 | 1990 |
|
|
|
-| month | int | 月份 | 5 |
|
|
|
-| day | int | 日期 | 15 |
|
|
|
-| hour | int | 小时 | 14 |
|
|
|
-| minute | int | 分钟 | 30 |
|
|
|
-| sex | int | 性别 | 1男 0女 |
|
|
|
-
|
|
|
-### 可选参数
|
|
|
-| 参数 | 类型 | 默认值 | 说明 |
|
|
|
-|------|------|--------|------|
|
|
|
-| islunar | int | 0 | 是否农历 (0阳历 1农历) |
|
|
|
-| istaiyang | int | 0 | 是否太阳时 (0否 1是) |
|
|
|
-| islunarmonth | int | 2 | 是否闰月 (1是 2否) |
|
|
|
-
|
|
|
-## 🏆 API返回数据解析
|
|
|
-
|
|
|
-### 基础八字信息
|
|
|
-```javascript
|
|
|
-{
|
|
|
- "bazi": ["己丑", "甲戌", "丙申", "己丑"], // 八字四柱
|
|
|
- "nayin": ["霹雳火", "山头火", "山下火", "霹雳火"], // 纳音
|
|
|
- "animal": "牛", // 生肖
|
|
|
- "yearganzhi": "己丑" // 年干支
|
|
|
-}
|
|
|
-```
|
|
|
-
|
|
|
-### 专业命理信息
|
|
|
-```javascript
|
|
|
-{
|
|
|
- "taiyuan": "乙丑", // 胎元
|
|
|
- "minggong": "庚午", // 命宫
|
|
|
- "xunkong": ["午未", "申酉", "辰巳", "午未"], // 旬空
|
|
|
- "qiyun": { // 起运时间
|
|
|
- "year": "3",
|
|
|
- "month": "2",
|
|
|
- "day": "12"
|
|
|
- },
|
|
|
- "shensha": [ // 神煞
|
|
|
- ["太极贵人", "华盖", "国印贵人"],
|
|
|
- ["太极贵人", "寡宿", "吊客"]
|
|
|
- ]
|
|
|
-}
|
|
|
-```
|
|
|
-
|
|
|
-### 大运流年信息
|
|
|
-```javascript
|
|
|
-{
|
|
|
- "dayun": { // 大运
|
|
|
- "ganzhi": ["甲戌", "癸酉", "壬申"],
|
|
|
- "sui": ["1-2岁", "3岁", "13岁", "23岁"]
|
|
|
- },
|
|
|
- "liunian": [ // 流年
|
|
|
- ["己丑", "壬辰", "壬寅"]
|
|
|
- ]
|
|
|
-}
|
|
|
-```
|
|
|
-
|
|
|
-## 💡 实际使用示例
|
|
|
-
|
|
|
-### 调用示例
|
|
|
-```javascript
|
|
|
-// 在您的八字测算页面中
|
|
|
-async calculateBazi() {
|
|
|
- try {
|
|
|
- const birthDateObj = new Date(this.birthDate + ' 12:00:00')
|
|
|
-
|
|
|
- // 使用增强版API调用
|
|
|
- const baziData = await baziUtil.calculateEnhancedBaZi(
|
|
|
- birthDateObj,
|
|
|
- this.selectedHour
|
|
|
- )
|
|
|
-
|
|
|
- console.log('八字结果:', baziData)
|
|
|
-
|
|
|
- if (baziData.apiProvider === 'jisuapi') {
|
|
|
- console.log('🎉 使用极速数据专业API结果')
|
|
|
- console.log('生肖:', baziData.animal)
|
|
|
- console.log('胎元:', baziData.taiyuan)
|
|
|
- console.log('命宫:', baziData.minggong)
|
|
|
- // ... 更多专业信息
|
|
|
- }
|
|
|
-
|
|
|
- } catch (error) {
|
|
|
- console.error('测算失败:', error)
|
|
|
- }
|
|
|
-}
|
|
|
-```
|
|
|
-
|
|
|
-### 前端显示增强
|
|
|
-```vue
|
|
|
-<!-- 在八字结果页面显示更多专业信息 -->
|
|
|
-<view class="professional-info" v-if="baziAnalysis.apiProvider === 'jisuapi'">
|
|
|
- <view class="section-title">🏆 专业版信息</view>
|
|
|
-
|
|
|
- <!-- 生肖信息 -->
|
|
|
- <view class="info-item">
|
|
|
- <text class="info-label">生肖:</text>
|
|
|
- <text class="info-value">{{ baziAnalysis.animal }}</text>
|
|
|
- </view>
|
|
|
-
|
|
|
- <!-- 胎元命宫 -->
|
|
|
- <view class="info-item">
|
|
|
- <text class="info-label">胎元:</text>
|
|
|
- <text class="info-value">{{ baziAnalysis.taiyuan }}</text>
|
|
|
- </view>
|
|
|
-
|
|
|
- <view class="info-item">
|
|
|
- <text class="info-label">命宫:</text>
|
|
|
- <text class="info-value">{{ baziAnalysis.minggong }}</text>
|
|
|
- </view>
|
|
|
-
|
|
|
- <!-- 农历信息 -->
|
|
|
- <view class="info-item" v-if="baziAnalysis.lunar">
|
|
|
- <text class="info-label">农历:</text>
|
|
|
- <text class="info-value">
|
|
|
- {{ baziAnalysis.lunar.year }}.{{ baziAnalysis.lunar.month }}.{{ baziAnalysis.lunar.day }}
|
|
|
- </text>
|
|
|
- </view>
|
|
|
-</view>
|
|
|
-```
|
|
|
-
|
|
|
-## 💰 成本分析
|
|
|
-
|
|
|
-### 套餐对比
|
|
|
-| 套餐类型 | 次数 | 价格 | 单价 | 适用场景 |
|
|
|
-|----------|------|------|------|----------|
|
|
|
-| 免费套餐 | 10次 | 0元 | 0元/次 | 功能测试 |
|
|
|
-| Level1 | 10000次 | 980元 | 0.098元/次 | 个人项目 |
|
|
|
-| Level2 | 20000次 | 1940元 | 0.097元/次 | 小型企业 |
|
|
|
-| Level1特惠 | 1000次/天 | 2320元/月 | 0.077元/次 | 高频使用 |
|
|
|
-
|
|
|
-### 使用量估算
|
|
|
-- **个人测试**: 免费10次足够验证功能
|
|
|
-- **小程序上线**: 建议Level1套餐(10000次)
|
|
|
-- **日均100次**: 月成本约300元
|
|
|
-- **商业运营**: 建议包月套餐
|
|
|
-
|
|
|
-## ⚠️ 重要注意事项
|
|
|
-
|
|
|
-### 1. API Key保护
|
|
|
-```javascript
|
|
|
-// ❌ 错误:直接暴露在前端
|
|
|
-const API_KEY = 'your_real_api_key'
|
|
|
-
|
|
|
-// ✅ 正确:配置文件中管理
|
|
|
-JISU_API: {
|
|
|
- API_KEY: process.env.JISU_API_KEY || 'YOUR_JISU_API_KEY'
|
|
|
-}
|
|
|
-```
|
|
|
-
|
|
|
-### 2. 错误处理
|
|
|
-```javascript
|
|
|
-// 完善的错误处理
|
|
|
-try {
|
|
|
- const result = await getBaziFromAPI(birthDate, hour)
|
|
|
- if (!result) {
|
|
|
- console.log('⚠️ API调用失败,使用本地算法')
|
|
|
- // 自动降级到本地算法
|
|
|
- }
|
|
|
-} catch (error) {
|
|
|
- if (error.status === 104) {
|
|
|
- console.log('❌ API次数用完,请充值')
|
|
|
- // 提醒用户充值或升级套餐
|
|
|
- }
|
|
|
-}
|
|
|
-```
|
|
|
-
|
|
|
-### 3. API次数监控
|
|
|
-建议添加调用次数统计:
|
|
|
-```javascript
|
|
|
-// 简单的次数统计
|
|
|
-function logAPIUsage(provider, cost) {
|
|
|
- const today = new Date().toDateString()
|
|
|
- const usage = uni.getStorageSync('apiUsage') || {}
|
|
|
-
|
|
|
- if (!usage[today]) usage[today] = { calls: 0, cost: 0 }
|
|
|
- usage[today].calls++
|
|
|
- usage[today].cost += cost
|
|
|
-
|
|
|
- uni.setStorageSync('apiUsage', usage)
|
|
|
-}
|
|
|
-```
|
|
|
-
|
|
|
-## 🚀 上线检查清单
|
|
|
-
|
|
|
-- [ ] ✅ API Key已正确配置
|
|
|
-- [ ] ✅ 小程序域名白名单已添加
|
|
|
-- [ ] ✅ 免费10次测试通过
|
|
|
-- [ ] ✅ 错误处理机制完善
|
|
|
-- [ ] ✅ 本地算法兜底正常
|
|
|
-- [ ] ✅ 套餐充值流程确认
|
|
|
-- [ ] ✅ 使用量监控部署
|
|
|
-
|
|
|
-## 🎯 预期效果
|
|
|
-
|
|
|
-配置完成后,您的八字测算将获得:
|
|
|
-
|
|
|
-### 🏆 专业级准确度
|
|
|
-- **本地算法**: 75-80%准确度
|
|
|
-- **极速数据API**: 95%+准确度
|
|
|
-- **用户信任度**: 显著提升
|
|
|
-
|
|
|
-### 🎨 丰富的展示内容
|
|
|
-- 基础八字四柱
|
|
|
-- 农历信息对照
|
|
|
-- 纳音五行详解
|
|
|
-- 胎元命宫分析
|
|
|
-- 神煞详细信息
|
|
|
-- 大运流年预测
|
|
|
-
|
|
|
-### 💡 智能降级保护
|
|
|
-- API正常时使用专业结果
|
|
|
-- API异常时自动切换本地算法
|
|
|
-- 用户体验无感知
|
|
|
-
|
|
|
-## 📞 技术支持
|
|
|
-
|
|
|
-### 极速数据官方支持
|
|
|
-- **客服电话**: 0571-56565366
|
|
|
-- **客服邮箱**: kf@jisuapi.com
|
|
|
-- **技术文档**: https://www.jisuapi.com/api/bazi/
|
|
|
-
|
|
|
-### 常见问题
|
|
|
-1. **API调用失败**: 检查域名白名单和API Key
|
|
|
-2. **次数不足**: 登录后台查看剩余次数
|
|
|
-3. **数据格式异常**: 检查请求参数是否完整
|
|
|
-
|
|
|
----
|
|
|
-
|
|
|
-🎉 **恭喜您获得了专业级的八字测算能力!**
|
|
|
-
|
|
|
-这套系统将让您的产品在同类应用中脱颖而出,为用户提供真正可信的专业测算服务。
|
|
|
-
|
|
|
-需要进一步的技术支持或功能定制,随时联系我!
|