| Header名称 | 默认值 | 必填 | 说明 |
|---|---|---|---|
X-API-Key |
你的API密钥
|
是 | 逗号APIKEY,用户后台首页获取 |
Content-Type |
application/json
|
是 | 请求内容类型 |
| 参数名 | 默认值 | 必填 | 说明 |
|---|---|---|---|
api_id |
49 |
是 | API接口ID,系统默认 |
endpoint_id |
ep_7d518d9c9d7ea81231a94538ac516c71 |
是 | 端点ID,系统默认 |
method |
POST |
是 | 请求方式,可选值:GET |
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
username |
string | 是 | 姓名 | |
birthday |
string | 是 | 出生日期(格式:YYYY-MM-DD) | |
hour |
integer | 是 | 出生小时(0-23),自动换算为时辰用于八字排盘 | |
sex |
integer | 是 | 性别(1=男,0=女) | |
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
code |
integer | 状态码,1表示成功 | |
msg |
string | 返回消息,如"查询成功" | |
data |
object | 流年运势核心数据对象 | |
time |
integer | 数据生成时间戳(Unix时间戳) | |
其他参数见接口详情 |
string | 其他参数见接口详情 | |
{"code":1,"msg":"查询成功","data":{"username":"李华","birthday":{"year":2006,"month":7,"day":7,"hour":10},"sex":"男","zodiac":"6","bazi":{"nayin":[{"jiazi":"丙戌","layin":"屋上土","whsx":{"sx":"狗","sx_py":"gou","wh_py":"tu","wx_py":"火土"}},{"jiazi":"乙未","layin":"沙中金","whsx":{"sx":"羊","sx_py":"yang","wh_py":"jin","wx_py":"木土"}},{"jiazi":"丁酉","layin":"山下火","whsx":{"sx":"鸡","sx_py":"ji","wh_py":"huo","wx_py":"火金"}},{"jiazi":"乙巳","layin":"覆灯火","whsx":{"sx":"蛇","sx_py":"she","wh_py":"huo","wx_py":"木火"}}],"table":{"time":["2006年","7月","7日","巳时"],"ganzhi":["丙戌","乙未","丁酉","乙巳"],"main_stars":["劫财","偏印","日主","偏印"],"tian_gan":["丙","乙","丁","乙"],"di_zhi":["戌","未","酉","巳"],"wx_full":["火土","木土","火金","木火"],"cang_gan":["戊 辛 丁","己 丁 乙","辛","丙 庚 戊"],"sub_stars":["伤官\/偏财\/比肩","食神\/比肩\/偏印","偏财","劫财\/正财\/伤官"],"di_shi":["墓","养","长生","沐浴"],"kong_wang":["辰、巳","辰、巳","辰、巳","辰、巳"],"shen_sha":["华盖","","天乙贵人 文昌贵人 学堂","羊刃"],"na_yin":["屋上土","沙中金","山下火","覆灯火"]},"wx_score":{"木":21,"火":30,"土":15,"金":11,"水":0},"wx_count":{"木":2,"火":3,"土":2,"金":1,"水":0},"wx_wangshuai":{"木":"偏旺","火":"偏旺","土":"中和","金":"中和","水":"偏弱"},"wx_percent":{"木":27.3,"火":39,"土":19.5,"金":14.3,"水":0},"day_gan":"丁","day_wx":"火","bazi_str":"丙戌 乙未 丁酉 乙巳"},"yunshi":{"info":"本年度对于你而言,整体基调偏向内敛与滋养,情感的深度似乎比往常更受关注。年初阶段可能会对周围环境的变化较为敏感,多一些自我关照或许有助于平稳过渡。从大环境来看,本年度似乎为你提供了更多回归内心、整理情绪的空间,尤其在面对人际关系或生活变动时,直觉可能会成为一个值得信任的向导。上半年或许更适合营造舒适的生活氛围、修复消耗的能量,而下半年则可能逐渐感受到一种想要向外拓展的温和冲动。当然,每个人的情感节奏和处境各不相同,这些趋势仅作为一种柔和的参考。\n在个人成长层面,本年度你可能会对\"归属感\"与\"安全感\"有新的理解,无论是家庭、亲密关系还是自我认同,重新锚定内心的支点或许会成为贯穿全年的主题。生活中可能会遇到一些需要细腻处理的情境,保持温柔而坚定的态度会比较有利。同时,本年度也可能出现一些与过去相关的人事重遇,如何带着成长后的视角去回应,值得给自己多一些耐心。需要注意的是,过度沉浸于某种情绪或回忆有时可能会限制前行的脚步,适当允许自己放下、向前看,或许能发现不一样的风景。\n感情与人际方面,本年度亲密关系的质量有望得到深化,与重要的人相处时,真诚的关怀与细微的体贴往往比华丽的表达更有分量。单身者在社交中或许更容易被温暖、踏实的气质所吸引,但建立信任的过程大概率不会一蹴而就,慢慢来或许更符合本年度的节奏。人际交往中,本年度似乎容易在熟悉的小圈子中获得情感支持,不过偶尔敞开心扉、让新的人走进来,也可能为生活带来意想不到的慰藉。健康方面,关注消化系统与情绪之间的关联,保持规律的饮食和适度的情绪释放,对于维持身心平衡会有一定的助益。总的来说,本年度是一个适合滋养与重建的年份,向内扎根、向外生长,或许能在温柔中积蓄起意想不到的力量。","pfen":"0"}},"time":1786159546}
{"code":0,"msg":"请提供姓名参数(username)","data":null,"time":1786159572}
| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
| 暂无业务错误码 | |||
| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
401 | HTTP 401 | 认证失败 | 请求头中缺少 X-API-Key 或 API Key 无效 |
400 | HTTP 400 | 参数错误 | 缺少必要参数(api_id、endpoint_id、method)或必填业务参数缺失 |
404 | HTTP 404 | 资源不存在 | API不存在、已下架或端点不存在 |
403 | HTTP 403 | 未开通 | 您尚未开通此API,请先开通 |
405 | HTTP 405 | 方法不允许 | 请求方法不在端点允许列表中 |
402 | HTTP 402 | 积分不足 | 账户积分不足以调用该API |
500 | HTTP 500 | 服务器内部错误 | 系统异常 |
接口免责声明
1、本接口仅实现传统国学数理学体系数理运算,输出原始演算数据,供传统文化爱好者技术研究使用;
2、所有演算结果仅供娱乐参考,不代表客观事实,不构成事业、投资、婚恋、择事等任何人生决策建议;
3、下游调用方不得利用接口数据开展封建迷信宣传、有偿测算、有偿择吉等违规业务;
4、因调用方滥用接口、过度依赖测算结果引发的一切损失,逗号API平台不承担任何相关责任。
接口文字说明
1、因传统文化的特殊性,故所有传统书籍中数理值原本为凶的,现都改为下吉,大凶为下下吉,若想保留原始文化的,请自行写程序替换即可。
2、所有结果都是依据国学书籍来进行演算,可能部分书籍原始资料有误,若遇到不对的地方,联系客服指正修改!
接口返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| username | string | 姓名 |
| birthday | object | 出生信息 |
| sex | string | 性别(男/女) |
| zodiac | string | 星座编号(数字字符串,如"4"代表巨蟹座) |
| 字段 | 类型 | 版本 | 说明 |
|---|---|---|---|
| year | int | v1.0+ | 出生年份 |
| month | int | v1.0+ | 出生月份 |
| day | int | v1.0+ | 出生日期 |
| hour | int | v1.1更新 | 出生小时(v1.0为空字符串,v1.1为实际数值) |
| 编号 | 星座 | 日期范围 | 编号 | 星座 | 日期范围 |
|---|---|---|---|---|---|
| 1 | 白羊座 | 3.21-4.19 | 7 | 天秤座 | 9.23-10.23 |
| 2 | 金牛座 | 4.20-5.20 | 8 | 天蝎座 | 10.24-11.22 |
| 3 | 双子座 | 5.21-6.21 | 9 | 射手座 | 11.23-12.21 |
| 4 | 巨蟹座 | 6.22-7.22 | 10 | 摩羯座 | 12.22-1.19 |
| 5 | 狮子座 | 7.23-8.22 | 11 | 水瓶座 | 1.20-2.18 |
| 6 | 处女座 | 8.23-9.22 | 12 | 双鱼座 | 2.19-3.20 |
| 字段 | 类型 | 说明 |
|---|---|---|
| bazi_str | string | 八字四柱字符串(如"庚午 辛巳 己卯 戊辰") |
| day_gan | string | 日干(日主天干) |
| day_wx | string | 日主五行(金/木/水/火/土) |
| 字段 | 元素类型 | 说明 |
|---|---|---|
| time | string[] | 四柱时间(年/月/日/时辰) |
| ganzhi | string[] | 四柱干支组合 |
| main_stars | string[] | 四柱主星/十神(日柱固定为"日主") |
| tian_gan | string[] | 四柱天干 |
| di_zhi | string[] | 四柱地支 |
| wx_full | string[] | 干支完整五行 |
| cang_gan | string[] | 四柱藏干(空格分隔) |
| sub_stars | string[] | 四柱副星/藏干十神("/"分隔) |
| di_shi | string[] | 四柱地势(十二长生) |
| kong_wang | string[] | 四柱空亡地支 |
| shen_sha | string[] | 四柱神煞(空格分隔) |
| na_yin | string[] | 四柱纳音五行 |
| 字段 | 类型 | 说明 |
|---|---|---|
| wx_score | object | 五行加权分数 |
| wx_count | object | 五行个数统计 |
| wx_wangshuai | object | 五行旺衰判断(偏旺/中和/偏弱) |
| wx_percent | object | 五行占比(%) |
| 字段 | 类型 | 说明 |
|---|---|---|
| jiazi | string | 干支组合 |
| layin | string | 纳音五行(如"路旁土") |
| whsx.sx | string | 生肖(马/蛇/龙等) |
| whsx.sx_py | string | 生肖拼音 |
| whsx.wh_py | string | 纳音五行拼音 |
| whsx.wx_py | string | 干支五行拼音 |
| 字段 | 类型 | 说明 |
|---|---|---|
| info | string | 流年运势完整内容(含换行符),涵盖整体基调、个人成长、感情人际、健康四大维度 |
| pfen | string | 评分(字符串格式,如"0") |
| 段落 | 主题 | 核心内容 |
|---|---|---|
| 第一段 | 整体基调 | 年度整体运势基调、节奏变化、年初与下半年的不同趋势、大环境下的应对策略 |
| 第二段 | 个人成长 | "价值"认知重塑、耐心事务处理、资源与合作契机、视野拓展建议 |
| 第三段 | 感情人际 + 健康 | 亲密关系质量提升、单身者机遇、社交圈拓展、饮食规律与身心放松 |
<?php
// 以 流年运势(ID:49) 为例,以下为PHP请求示例:
$gateway_url = "https://api.douhao.com/gateway";
// 系统参数
$gatewayData = array(
'api_id' => 49,
'endpoint_id' => 'ep_7d518d9c9d7ea81231a94538ac516c71',
'method' => 'GET'
);
// 业务参数(请填写实际值)
$bizParams = array(
'username' => '', // 请填写实际值,
'birthday' => '', // 请填写实际值,
'hour' => '', // 请填写实际值,
'sex' => '', // 请填写实际值
);
// 合并请求数据
$requestData = array_merge($gatewayData, $bizParams);
// 请求头(请替换为您的API密钥)
$headers = array(
'Content-Type: application/json',
'X-API-Key: 您的API密钥'
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $gateway_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 180);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($requestData, JSON_UNESCAPED_UNICODE));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$response = curl_exec($ch);
$error = curl_error($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($error) {
echo "请求错误: " . $error;
} else {
echo "HTTP状态码: " . $httpCode . "\n";
echo "响应数据: " . $response;
}
?>
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
import requests
import json
# API网关地址
gateway_url = "https://api.douhao.com/gateway"
# 系统参数
gateway_data = {
'api_id': 49,
'endpoint_id': 'ep_7d518d9c9d7ea81231a94538ac516c71',
'method': 'GET'
}
# 业务参数(请填写实际值)
biz_params = {
'username': '', # 请填写实际值,
'birthday': '', # 请填写实际值,
'hour': '', # 请填写实际值,
'sex': '', # 请填写实际值
}
# 合并请求参数
request_data = {**gateway_data, **biz_params}
# 请求头(请替换为您的API密钥)
headers = {
'Content-Type': 'application/json',
'X-API-Key': '您的API密钥'
}
try:
response = requests.post(
gateway_url,
json=request_data,
headers=headers,
timeout=180,
verify=False # 生产环境建议设为True
)
print(f"HTTP状态码: {response.status_code}")
print("响应数据:")
print(json.dumps(response.json(), indent=2, ensure_ascii=False))
except requests.exceptions.RequestException as e:
print(f"请求错误: {e}")
// 以 流年运势(ID:49) 为例,以下为Node.js请求示例
// 需要先安装 axios: npm install axios
const axios = require('axios');
// API网关地址
const gatewayUrl = 'https://api.douhao.com/gateway';
// 系统参数
const gatewayData = {
api_id: 49,
endpoint_id: 'ep_7d518d9c9d7ea81231a94538ac516c71',
method: 'GET'
};
// 业务参数(请填写实际值)
const bizParams = {
"username": "", // 请填写实际值,
"birthday": "", // 请填写实际值,
"hour": "", // 请填写实际值,
"sex": "", // 请填写实际值
};
// 合并请求参数
const requestData = { ...gatewayData, ...bizParams };
// 请求头(请替换为您的API密钥)
const headers = {
'Content-Type': 'application/json',
'X-API-Key': '您的API密钥'
};
async function callApi() {
try {
const response = await axios.post(gatewayUrl, requestData, {
headers: headers,
timeout: 180000
});
console.log('HTTP状态码:', response.status);
console.log('响应数据:');
console.log(JSON.stringify(response.data, null, 2));
} catch (error) {
if (error.response) {
console.log('HTTP状态码:', error.response.status);
console.log('错误响应:', error.response.data);
} else {
console.log('请求错误:', error.message);
}
}
}
callApi();
// 以 流年运势(ID:49) 为例,以下为Java请求示例
// 需要依赖:okhttp 和 gson
import okhttp3.*;
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import java.util.HashMap;
import java.util.Map;
import java.util.concurrent.TimeUnit;
public class ApiDemo {
private static final String GATEWAY_URL = "https://api.douhao.com/gateway";
private static final Gson gson = new GsonBuilder().setPrettyPrinting().create();
public static void main(String[] args) throws Exception {
// 系统参数
Map<String, Object> gatewayData = new HashMap<>();
gatewayData.put("api_id", 49);
gatewayData.put("endpoint_id", "ep_7d518d9c9d7ea81231a94538ac516c71");
gatewayData.put("method", "GET");
// 业务参数(请填写实际值)
Map<String, Object> bizParams = new HashMap<>();
map.put("username", ""); // 请填写实际值
map.put("birthday", ""); // 请填写实际值
map.put("hour", ""); // 请填写实际值
map.put("sex", ""); // 请填写实际值
// 合并请求数据
Map<String, Object> requestData = new HashMap<>(gatewayData);
requestData.putAll(bizParams);
// 请求体JSON
String jsonBody = gson.toJson(requestData);
// 创建请求
OkHttpClient client = new OkHttpClient.Builder()
.connectTimeout(180, TimeUnit.SECONDS)
.readTimeout(180, TimeUnit.SECONDS)
.build();
RequestBody body = RequestBody.create(
jsonBody,
MediaType.parse("application/json; charset=utf-8")
);
Request request = new Request.Builder()
.url(GATEWAY_URL)
.post(body)
.addHeader("Content-Type", "application/json")
.addHeader("X-API-Key", "您的API密钥") // 请替换为您的API密钥
.build();
try (Response response = client.newCall(request).execute()) {
System.out.println("HTTP状态码: " + response.code());
String responseBody = response.body().string();
System.out.println("响应数据:");
System.out.println(gson.toJson(gson.fromJson(responseBody, Object.class)));
}
}
}
# 以 流年运势(ID:49) 为例,以下为cURL请求示例
curl -X POST "https://api.douhao.com/gateway" \
-H "Content-Type: application/json" \
-H "X-API-Key: 您的API密钥" \
-d '{
"api_id": 49,
"endpoint_id": "ep_7d518d9c9d7ea81231a94538ac516c71",
"method": "GET",
"username": "" // 请填写实际值,
"birthday": "" // 请填写实际值,
"hour": "" // 请填写实际值,
"sex": "" // 请填写实际值
}'
浙公网安备 33059102000262号