README

免费算命API / 八字排盘接口 / 星座运势API / 塔罗牌占卜API / 紫微斗数API
支持：八字分析、合婚配对、每日运势、星盘排盘等能力（含完整分析文案输出，可直接用于产品上线） 3分钟接入，即可实现完整八字排盘 / 占星 / 运势分析系统（含分析文案）

🚀 项目简介

本 SDK 是「缘份居」提供的官方 PHP 开发工具包，用于快速接入传统文化相关的数据分析与内容生成能力。

通过本 SDK，你可以在几分钟内完成接口调用，无需关心复杂的签名算法、HTTP 请求封装等底层细节。

适用场景：

🛠️ 工具类网站（信息查询 / 娱乐应用）
📝 内容生成（文章 / 解读文案）
📱 小程序 / Web 应用快速集成

✨ 功能特性（v1）

生辰信息分析（基础排盘）
合盘关系分析（契合度参考）
每日运势参考（趋势信息）
基础排盘数据（紫微 / 星盘等）

💡 更多高级能力与完整参数说明，请参考 👉 https://doc.yuanfenju.com

📦 安装

推荐使用 Composer 安装：

composer require yuanfenju/sdk

⚡ 快速开始（3分钟跑通）

<?php

require 'vendor/autoload.php';

use Yuanfenju\Sdk\Client;
use Yuanfenju\Sdk\Exception\ApiException;

// 1. 初始化 SDK
$client = new Client('你的_API_KEY');

try {
    // 2. 调用生辰分析接口
    $result = $client->getBaziPaipan([
        'name'   => '张三',
        'sex'    => 1,           // 1女 0男
        'type'   => 1,           // 0农历 1公历
        'year'   => 1990,
        'month'  => 1,
        'day'    => 1,
        'hours'  => 8,
        'minute' => 0
    ]);

    print_r($result);

} catch (ApiException $e) {
    echo "请求失败: " . $e->getMessage();
}

🎯 在线演示（可直接体验 + 快速搭建）

👉 https://store.yuanfenju.com

输入生辰信息，即可查看完整排盘与分析结果（与 API 返回一致）

💡 可直接作为网站 / 小程序前端展示方案
🎁 提供完整演示站源码（含前端页面 + 调用逻辑）
🚀 无需从0开发，最快当天上线同类产品
🌐 演示站数据即来源于真实 API 接口（非静态演示）

📊 返回示例（部分）

{
  "errcode": 0,
  "errmsg": "请求成功",
  "data": {
    "base_info": {
      "name": "张三",
      "sex": "坤造",
      "gongli": "1988年1月8日12时20分",
      "nongli": "丁卯年 十一月 十九日 午时",
      "bazi": "丁卯 癸丑 壬戌 丙午",
      "wuxing": "水火土均衡"
    },
    "description": "此命五行较为平衡，日元壬水，性格稳重，适合从事稳定型行业..."
  }
}

💡 返回结果已包含完整分析文案，可直接用于页面展示或内容生成
👉 完整数据（含大运 / 流年 / 神煞等）请查看开发文档
🚀 已适配前端展示结构，可直接用于结果页渲染

🚀 接口能力总览（近百种能力）

缘份居 API 提供覆盖多领域的传统文化与分析能力，支持快速搭建各类应用与内容系统。

🔮 命理排盘与分析

可用于搭建算命 / 排盘 / 命理分析类应用：

八字排盘 / 精盘 / 测算 / 运势分析
紫微斗数排盘 / 流盘分析
九星命理 / 称骨论命 / 生日论命
流年财运 / 每日运势

⭐ 西方占星系统

完整占星能力支持：

本命盘 / 比较盘 / 组合盘
行运盘 / 次限盘 / 太阳弧
日返照 / 月返照

🧿 术数与传统占卜

支持多种术数排盘与占卜能力：

奇门遁甲 / 六爻 / 梅花易数
大六壬 / 金口诀
塔罗牌占卜（单牌 / 多牌阵）
小六壬 / 摇卦占卜

💞 关系与配对分析

适用于情感 / 社交类产品：

八字合婚 / 八字合盘
姓名 / 生肖 / 星座配对
手机号 / QQ号 / 血型配对

📈 趋势与命运分析

支持长期趋势判断：

命运趋势 / 财运趋势
姻缘趋势 / 结婚趋势
六道轮回 / 正缘画像

🔢 数理与吉凶分析

适用于娱乐 / 工具类应用：

手机号 / 车牌 / QQ号测吉凶
身份证 / 数字分析
公司名 / 姓名打分

🧠 图像与特征分析

结合 AI 能力：

手相分析
面相分析

🏮 民俗与文化类功能

适用于内容型产品：

灵签（观音 / 月老 / 吕祖等）
周公解梦
老黄历 / 节气工具

🛠️ 基础工具能力

开发辅助工具：

干支计算 / 阴阳历转换
八字反查
择吉日 / 流日流时

👉 查看完整接口文档（含参数 & 示例）

https://doc.yuanfenju.com

💡 所有接口均支持「结构化数据 + 分析文案输出」，可直接用于产品开发
🚀 结合演示站模板，可快速搭建完整业务系统（无需从0开发）

📁 示例代码

项目中提供完整示例，修改 API_KEY 即可运行：

examples/
├── bazi_paipan.php    # 八字排盘
├── bazi_cesuan.php    # 八字测算
├── bazi_yunshi.php    # 八字运势

📌 核心接口说明（SDK仅展示部分能力）

功能	方法
八字排盘	`$client->getBaziPaipan($params)`
八字测算	`$client->getBaziCesuan($params)`
八字运势	`$client->getBaziYunshi($params)`

当前 SDK 示例仅包含部分常用接口，平台实际提供近百种功能

🧩 通用调用（支持全部 API）

对于 SDK 尚未封装的接口，可使用通用方法：

$result = $client->request('/api/v1/Bazi/hehun', $params, 'POST');

🔑 免费获取 API Key（注册即用）

👉 https://doc.yuanfenju.com
👉 在线演示：https://store.yuanfenju.com

⚡ 注册后即可调用接口
🎁 新用户赠送调用额度
🚀 3分钟跑通，1小时内可完成基础产品搭建

⚠️ 使用说明（免责声明）

本 SDK 及缘份居 API 提供的是基于传统文化模型的数据分析结果，仅供技术研究、娱乐与参考使用。

不构成任何现实决策建议（包括但不限于投资、医疗、法律等场景）。

请合理、合规地使用相关数据内容。

📈 商业支持

如需以下支持，请访问官网联系：

🚀 高并发调用额度
🛡️ 商业授权 / SLA 支持
🛠️ 定制接口 / 私有化部署

📄 License

MIT License

🌐 关于我们

缘份居专注于传统文化数据的结构化与技术化，致力于为开发者提供稳定、易用、可扩展的接口服务能力。

👉 https://doc.yuanfenju.com

yuanfenju / sdk

Maintainers

Package info

Statistics

Security