文档说明

福运盘上线于 2020 年，是一家专注于国学文化数据服务的平台。我们致力于通过先进的技术手段，让古老而珍贵的国学文化更加容易被人们理解、学习和传承。

本文档面向开发者，提供 60+ 个专业国学算命 API 接口，涵盖八字命理、紫微斗数、奇门遁甲、周公解梦、灵签占卜、号码吉凶、缘份配对、姓名学、风水等领域。所有接口返回标准 JSON 格式，可快速集成到您的网站、APP 或小程序。

补充说明：如需查看前台网站用户的 VIP / SVIP 会员价格与权益，请前往 会员中心。本页仅说明开发者 API 套餐，不与网站会员体系混用。

免责声明：本接口提供国学文化研究数据，所有算法均为娱乐研究使用，不得作为生活、工作之指导，严禁用于封建迷信违法用途。使用者须遵守国家法律法规。

准备工作

1. 获取密钥

联系客服注册开发者账号，获取两个关键参数：

• X-User-ID — 您的商户 ID
• X-API-Key — 您的接口密钥（请妥善保管）

2. 请求方式

所有接口统一使用 POST 方式请求（面相/手相为文件上传），传参格式为 application/json，返回标准 JSON 结构。

3. 请求头

Content-Type: application/json
X-User-ID: 您的商户ID
X-API-Key: 您的接口密钥

4. 基础域名

http://api.fuyunpan.cn

5. 测试额度

新注册用户赠送 100 次免费测试调用，方便开发调试。

代理 API Key 申请使用流程

以下是从零开始申请并使用 API Key 的完整步骤：

提示：一个密钥可调用本平台所有接口，无需针对不同接口申请不同密钥。如需查看密钥余额和调用记录，请登录 会员中心 查看。

套餐价格

我们提供 次数会员 和 包年会员 两种服务模式。无论选择哪种会员类型，均可调用本平台的所有接口，仅在计费方式和有效期上有所不同。

所有套餐价格均已含税。次数会员和包年会员不可同时拥有，如需更换类型，联系客服按剩余价值计算差价。

次数会员

适用于调用频率不稳定、希望灵活计费的用户。购买后密钥长期有效，调用次数用尽为止。支持多套餐叠加购买。

折合单次价格按当前优惠价估算，实际以购买时订单金额为准。

包年会员

适用于每日调用量较为稳定的用户。系统按 24 小时为一个调用周期，调用上限每间隔 24 小时自动重置，密钥有效期一年。

包年会员已按不同调用规模提供对应档位，具体以页面展示价格为准。

包年不限次会员

密钥有效期一年，不限制每日调用次数，适合高频调用用户或企业级客户。

旗舰版面向高频调用与企业级接入场景，具体以页面展示价格为准。

全部接口列表（60+）

以下所有接口均为 POST 请求（面相/手相为文件上传），返回 JSON 格式。一个密钥可调用所有接口。

八字命理

紫微 / 排盘

占卜 / 灵签

西方占星

号码测吉凶

缘份配对

姓名学

查询 / 工具

🏠 风水堪舆

👤 大数据 / AI相术

命运预测系列 NEW

观香占卜 NEW

接口调用示例 — 八字测算

请求地址

POST http://api.fuyunpan.cn/api/v1/chart

请求参数

请求示例

{
  "name": "张三",
  "gender": 1,
  "year": 1990,
  "month": 6,
  "day": 15,
  "hour": "8-辰",
  "minute": 30,
  "date_type": 1
}

返回示例

{
  "bazi": "庚午 壬午 甲子 戊辰",
  "wuxing": { "金": 1, "木": 1, "水": 2, "火": 2, "土": 2 },
  "pattern": "正印格",
  "yongshen": "水",
  "summary": "..."
}

其余接口参数格式类似，详细参数表可联系客服获取完整文档。

灵签接口统一说明

佛祖、观音、诸葛、月老、妈祖、吕祖共 6 种灵签使用同一接口地址，通过 collection 参数区分：

POST http://api.fuyunpan.cn/api/v1/sign

{
  "collection": "观音灵签"   // 可选值：观音灵签/佛祖灵签/诸葛灵签/月老灵签/妈祖灵签/吕祖灵签
}

示例代码

Python

import requests

url = "http://api.fuyunpan.cn/api/v1/chart"
headers = {
    "Content-Type": "application/json",
    "X-User-ID": "您的商户ID",
    "X-API-Key": "您的接口密钥"
}
data = {
    "name": "张三", "gender": 1,
    "year": 1990, "month": 6, "day": 15,
    "hour": "8-辰", "minute": 30, "date_type": 1
}
resp = requests.post(url, json=data, headers=headers)
print(resp.json())

JavaScript (Node.js / 前端)

fetch("http://api.fuyunpan.cn/api/v1/chart", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-User-ID": "您的商户ID",
    "X-API-Key": "您的接口密钥"
  },
  body: JSON.stringify({
    name: "张三", gender: 1,
    year: 1990, month: 6, day: 15,
    hour: "8-辰", minute: 30, date_type: 1
  })
})
.then(res => res.json())
.then(data => console.log(data));

PHP

$ch = curl_init("http://api.fuyunpan.cn/api/v1/chart");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
        "X-User-ID: 您的商户ID",
        "X-API-Key: 您的接口密钥"
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "name" => "张三", "gender" => 1,
        "year" => 1990, "month" => 6, "day" => 15,
        "hour" => "8-辰", "minute" => 30, "date_type" => 1
    ])
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Java

HttpClient client = HttpClient.newHttpClient();
String json = "{\"name\":\"张三\",\"gender\":1,\"year\":1990,\"month\":6,\"day\":15,\"hour\":\"8-辰\",\"minute\":30,\"date_type\":1}";
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("http://api.fuyunpan.cn/api/v1/chart"))
    .header("Content-Type", "application/json")
    .header("X-User-ID", "您的商户ID")
    .header("X-API-Key", "您的接口密钥")
    .POST(HttpRequest.BodyPublishers.ofString(json))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

联系我们

如需购买套餐、获取完整接口文档、或有技术对接问题，欢迎通过以下方式联系：

• 官网：http://fuyunpan.cn
• 接口文档：开发者 API 套餐与定价
• 邮箱：api@fuyunpan.cn

我们承诺提供稳定、高效的 API 服务，7×24 小时系统监控，99.9% 可用性保障。