| Header名称 | 默认值 | 必填 | 说明 |
|---|---|---|---|
X-API-Key |
你的API密钥
|
是 | 逗号APIKEY,用户后台首页获取 |
Content-Type |
application/json
|
是 | 请求内容类型 |
| 参数名 | 默认值 | 必填 | 说明 |
|---|---|---|---|
api_id |
47 |
是 | API接口ID,系统默认 |
endpoint_id |
ep_d6f7a717b7c21d7e9605ea7cfcac85d2 |
是 | 端点ID,系统默认 |
method |
POST |
是 | 请求方式,可选值:GET |
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
username |
string | 是 | 姓名 | |
birthday |
string | 是 | 出生日期(格式:YYYY-MM-DD) | |
hour |
integer | 是 | 出生小时(0-23),自动换算为时辰 | |
sex |
integer | 是 | 性别(1=男,0=女) | |
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
| 暂无返回参数 | |||
{"code":1,"msg":"查询成功","data":{"username":"李飞","xs":"李","mz":"飞","birthday":{"year":"2026","month":7,"day":7,"hour":11},"sex":"男","shengxiao":"马","wuxing":{"j":0,"m":1,"s":1,"h":5,"t":1,"b":"水火","k":"金木土","w":"火","q":"金","o":null},"bazi":{"nayin":[{"jiazi":"丙午","layin":"天河水","whsx":{"sx":"马","sx_py":"ma","wh_py":"shui","wx_py":"火火"}},{"jiazi":"乙未","layin":"沙中金","whsx":{"sx":"羊","sx_py":"yang","wh_py":"jin","wx_py":"木土"}},{"jiazi":"壬午","layin":"杨柳木","whsx":{"sx":"马","sx_py":"ma","wh_py":"mu","wx_py":"水火"}},{"jiazi":"丙午","layin":"天河水","whsx":{"sx":"马","sx_py":"ma","wh_py":"shui","wx_py":"火火"}}],"table":{"time":["2026年","7月","7日","巳时"],"ganzhi":["丙午","乙未","壬午","丙午"],"main_stars":["偏财","伤官","日主","偏财"],"tian_gan":["丙","乙","壬","丙"],"di_zhi":["午","未","午","午"],"wx_full":["火火","木土","水火","火火"],"cang_gan":["丁 己","己 丁 乙","丁 己","丁 己"],"di_shi":["帝旺","养","胎","帝旺"],"kong_wang":[],"shen_sha":["将星","","将星","将星"],"na_yin":["天河水","沙中金","杨柳木","天河水"]},"wx_score":{"木":11,"火":43,"土":13,"金":0,"水":10},"wx_count":{"木":1,"火":5,"土":1,"金":0,"水":1},"day_gan":"壬","day_wx":"水","bazi_str":"丙午 乙未 壬午 丙午"},"bzjx":"## 整体\n\n属马人在2021年运势逐渐平稳,但又恰逢害太岁,仍然会受到部分冲击,主要反映在人际关系上,容易遭小人陷害中伤。但有月德吉星拱招,代表逢凶化吉,事业上有贵人相助;玉堂吉星代表金玉满堂,带来了不错的赚钱机会。但也有小耗凶星带来轻微破财;咸池桃花飞临,带来墙外桃花,已婚者要小心别卷入三角关系。害太岁年份人事较为纷乱,易遭小人陷害,需谨慎低调行事,不宜锋芒太露。\n## 财运\n\n牛年有代表金玉满堂的玉堂星拱照,财运逐渐顺遂。还有月德吉星带来强有力的贵人,加上使人际关系畅旺的咸池桃花,若从事销售等行业,有望凭借人缘使业绩提升。但仍有小耗凶星入主,会带来突如其来的开支,可能会破财漏财。以正财为主,不宜作高风险投资,亦不宜留太多现金,可主动购买实物保值,以破欢喜财的方式应验运势。\n## 事业\n\n事业上,喜获月德吉星带来贵人相助,长辈领导会对属马人赏识提拔,加上玉堂吉星,有升职加薪的机会。另有咸池桃花临门,此星利桃花及人缘,对从事地产、保险、销售者等行业比较有利,有望得到客户信任,业绩增长,收入翻番。不过人际关系不算顺利,与同事的关系紧张,要提防小人陷害,谨言慎行,以免拖垮本来不错的事业运。\n## 感情\n\n2021年属马人的桃花缘分畅旺,有利人缘的咸池桃花飞临,单身者魅力大增,有机会开展一段新恋情,但咸池桃花带来的多是镜花水月的短暂感情,难以修成正果。已婚者遇上此星代表墙外桃花,需要洁身自好,以免卷入三角关系。另外,要留心桃花破财情况,避免与异性发生金钱纠葛。破太岁年份人际较为复杂,感情运势顺利中暗藏变故,需要注意。\n## 健康\n\n2021年是害太岁的年份,会有皮肤敏感、鼻炎等琐碎小毛病,健康运被轻微冲击,可主动养生或购买医保提升健康运。另有咸池桃花星驾临,此星代表应酬、进入娱乐场所的机会较多,长期如此对健康比较不利,还需要适可而止、规律作息。另外,害太岁年份人际关系较为紧张,容易带来负面情绪和焦虑,建议多运动多亲近自然,以此放松身心。","wyjs":"## 命理基础信息\n\n生年地支:午年生。\n\n五行:午属火。\n\n五常:火属礼。\n\n吉吉祥方位:东北、西南及西北方。\n\n吉祥颜色:啡、黄、紫,忌蓝、白、金等色。\n\n幸运花:海芋、慈姑花、茉莉。。\n## 一生总概况及说明\n\n人从出生八字就已经固定了,无法去改变,每个八字都对应了相应的命理和运势,从您的八字命盘来看:您,午年生人,其性好动不好静,多喜出风头,而对社会交际极为巧妙,且多管他人事,备受人敬爱,并有贵人牵引以至成功,此人欲好外观,对内事缺乏观察,又好投机事业,且有怪癖之主张。致所思想及计划之事,难保其机密,此人有伶俐、敏速、为人亲切、好旅行、牺牲、自夸、焦燥、悲观的素质。\n\n古人云:命中注定!虽命中注定不可违,但我们可以从八字中获取一生的旺运和一生的劫数,旺运阶段,全力迎合,不可颓废,将运势最大化;劫数阶段,万分小心,不可懈怠,将劫数最小化。方能达到命中最好的结果,下面根据周易八字排盘数据列出您的一生旺运和劫数,请您细细斟酌与参考。\n\n## 一生的旺运\n\n25岁左右遇到贵人\n\n您拥有良好的社交能力,出门在外,能够结识到不少能够帮助到自己的朋友,在事业上,也能得到贵人的相助。25岁左右的您,虽然刚进入职场不久,但却能够充分发挥自身的优点,且眼光独到头脑很机灵,哪怕此时资历不够,可依旧会得到合作伙伴的垂青。这个年龄段的您,会利用自身的优势吸引很多贵人,积攒下强大的人脉,为将来的飞黄腾达做准备。虽然表面上看这个年龄段的您,还没有太大的成就,但未来的格局早已经注定,千万不可小瞧。\n\n37岁左右财运旺盛\n\n您的一生中注定会拥有很多财富,不过早年间大多四处奔走没有定性,钱财来的快去的也很快。您真正发家致富,要等到37岁左右,此时财运将达到第一次巅峰,事业上的逐渐稳定,会让正财方面的收入滚滚而来。经济有了基础之后,您将会充分发挥冒险的精神,在其他领域里一展风采。特别是地产和金融行业,对您来说很合适,独到的眼光和敏锐的市场嗅觉,会让您每每投资必将获利。这个年龄段,不管正财还是偏门财都很旺盛,同时也是您成家立业的时候,此时堪称他们人生中的辉煌时光。\n\n49岁左右名利双收\n\n成功的人生,不仅仅是拥有财富和地位,更需要拥有良好的口碑。您平时为人很豪爽,对待朋友也相当仗义,在朋友圈中口碑通常比较好。不过早年您由于年轻气盛,也很容易得罪他人,就算身边有很多好友支持,但难免有人在背后诋毁。不过您做事坦荡问心无愧,在进入50岁之后,一直以来积攒的口碑得到了体现。不管在职场上还是平时的朋友圈子中,您都非常受人尊重。到了这个年纪的您,不仅财富事业都有,家庭也很幸福,更重要的是在外口碑不错,可以说是名利双收,成为了人生赢家。\n\n## 一生的劫数\n\n28岁左右小人劫\n\n您的28岁左右会被小人陷害,生活变得困难起来,而且会因此失去一些人心的,这样的事情发生是很糟糕的。您这个年龄里的经验不够,是容易相信别人的话的,轻易的相信就会被利用了。您被小人纠缠上的时候自己想要的发展都会推迟,麻烦会变得越来越多。\n\n32岁左右情劫\n\n您的32岁左右有情劫,这一年里您面对感情的时候是左右为难的,感情上不能够果断的做出决定来。感情上您会越来越消极,您也容易因为一些暧昧关系而变得头痛。您这一年里面对感情是比较贪心的,什么都想要,最后很可能是什么都没有了的。\n\n45岁左右婚姻劫\n\n您的45岁左右婚姻生活上是有麻烦的,这样的事情发生很糟糕,您要多考虑自己伴侣的感受,面对婚姻的时候不能够太自私。您结婚之后是容易恃宠而骄的,慢慢的忘记了婚姻生活是需要维持的,时间久了之后,您就会失去自己的婚姻的,到时候是后悔都来不及了。\n\n52岁左右破财劫\n\n您的52岁左右会因为身边的人有金钱上的损失的,破财劫在这个时候到来了,您是很讲义气的人,由于您在49岁左右能够积累一定的财富,所以身边人有经济困难的时候您是会主动的帮助的。不过这一年里,您给出的帮助是有些盲目的,会忽略了自己的经济状况,最后给自己的经济状况带来了新的麻烦。","zjpo":"## 最佳配偶\n\n午马和未羊六合,所以属马人比较适合找一个属羊的对象,此乃上上等婚配。其次寅虎和戌狗三合,所以属虎和属狗也比较相配,,此乃上等婚配。午马与子鼠相冲,所以最忌找属鼠的,此乃下下等婚配。午马与丑牛相害,因此也要尽量避免找属牛的,此乃中下等婚配。有时又讲午午自刑,所以属马人也应该避免找同属相的配偶,此乃中下等婚配。\n## 最后总结\n\n总体来看,您您的一生过的十分精彩,事业运势也一直以来都很不错,在感情方面更是相当潇洒,人生中将会经历几段可贵的爱情。不过您真正富贵,还是在有了婚姻之后,因此婚后要忠于爱人,稳定夫妻关系,因为家庭的变故,容易给您带来负面的影响。另外,您对待子女比较宠溺,很可能导致孩子不争气,因此在这方面也要多多注意,避免过度呵护,否则影响了孩子的未来。"},"time":1786089500}
{"code":0,"msg":"请提供姓名参数(username)","data":null,"time":1786089464}
| 错误代码 | 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、所有结果都是依据国学书籍来进行演算,可能部分书籍原始资料有误,若遇到不对的地方,联系客服指正修改!
接口返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,1表示成功 |
| msg | string | 返回消息,如"查询成功" |
| data | object | 终生运势核心数据对象 |
| time | int | 数据生成时间戳(Unix时间戳) |
| 字段 | 类型 | 说明 |
|---|---|---|
| username | string | 姓名 |
| xs | string | 姓氏 |
| mz | string | 名字 |
| sex | string | 性别(男/女) |
| shengxiao | string | 生肖(如"马") |
| birthday | object | 出生信息 |
| 字段 | 类型 | 说明 |
|---|---|---|
| year | string | 出生年份 |
| month | int | 出生月份 |
| day | int | 出生日期 |
| hour | int | 出生小时 |
| 字段 | 类型 | 说明 |
|---|---|---|
| j | int | 金字个数 |
| m | int | 木字个数 |
| s | int | 水字个数 |
| h | int | 火字个数 |
| t | int | 土字个数 |
| b | string | 补益五行(喜用神) |
| k | string | 克泄五行(忌神) |
| w | string | 旺盛五行 |
| q | string | 缺失五行 |
| o | int|null | 五行种类数 |
| 字段 | 类型 | 说明 |
|---|---|---|
| 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[] | 四柱藏干(空格分隔) |
| di_shi | string[] | 四柱地势(十二长生) |
| kong_wang | array | 四柱空亡地支(可能为空数组) |
| shen_sha | string[] | 四柱神煞(空格分隔) |
| na_yin | string[] | 四柱纳音五行 |
| 字段 | 类型 | 说明 |
|---|---|---|
| wx_score | object | 五行加权分数 |
| wx_count | object | 五行个数统计 |
| 字段 | 类型 | 说明 |
|---|---|---|
| jiazi | string | 干支组合 |
| layin | string | 纳音五行 |
| whsx.sx | string | 生肖 |
| whsx.sx_py | string | 生肖拼音 |
| whsx.wh_py | string | 纳音五行拼音 |
| whsx.wx_py | string | 干支五行拼音 |
终身运势接口包含三大核心分析模块,均以Markdown格式富文本返回:
| 字段 | 类型 | 说明 |
|---|---|---|
| bzjx | string | 本命详解完整内容(Markdown格式),包含:整体运势、财运、事业、感情、健康五大维度 |
| 字段 | 类型 | 说明 |
|---|---|---|
| wyjs | string | 一生旺运劫数完整内容(Markdown格式),包含:命理基础信息、一生总概况、一生旺运(25岁/37岁/49岁)、一生劫数(28岁/32岁/45岁/52岁) |
| 字段 | 类型 | 说明 |
|---|---|---|
| zjpo | string | 最佳配偶完整内容(Markdown格式),包含:最佳配偶生肖配对、六合三合六冲六害说明、最后总结 |
| 段落 | 内容说明 |
|---|---|
| 整体 | 流年整体运势总评,太岁关系、吉星凶星分析 |
| 财运 | 正财偏财分析,投资建议,破财风险提示 |
| 事业 | 事业贵人、升职机会、行业建议 |
| 感情 | 桃花运、婚姻状况、人际关系 |
| 健康 | 身体隐患、养生建议 |
| 段落 | 内容说明 |
|---|---|
| 命理基础信息 | 生肖、五行、方位、幸运色、幸运花 |
| 一生总概况 | 性格总述与命理基调 |
| 一生的旺运 | 25岁贵人运、37岁财运、49岁名利双收 |
| 一生的劫数 | 28岁小人劫、32岁情劫、45岁婚姻劫、52岁破财劫 |
| 段落 | 内容说明 |
|---|---|
| 最佳配偶 | 六合生肖(上上等婚配) |
| 最后总结 | 人生总结与注意事项 |
<?php
// 以 终生运势(ID:47) 为例,以下为PHP请求示例:
$gateway_url = "https://api.douhao.com/gateway";
// 系统参数
$gatewayData = array(
'api_id' => 47,
'endpoint_id' => 'ep_d6f7a717b7c21d7e9605ea7cfcac85d2',
'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': 47,
'endpoint_id': 'ep_d6f7a717b7c21d7e9605ea7cfcac85d2',
'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:47) 为例,以下为Node.js请求示例
// 需要先安装 axios: npm install axios
const axios = require('axios');
// API网关地址
const gatewayUrl = 'https://api.douhao.com/gateway';
// 系统参数
const gatewayData = {
api_id: 47,
endpoint_id: 'ep_d6f7a717b7c21d7e9605ea7cfcac85d2',
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:47) 为例,以下为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", 47);
gatewayData.put("endpoint_id", "ep_d6f7a717b7c21d7e9605ea7cfcac85d2");
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:47) 为例,以下为cURL请求示例
curl -X POST "https://api.douhao.com/gateway" \
-H "Content-Type: application/json" \
-H "X-API-Key: 您的API密钥" \
-d '{
"api_id": 47,
"endpoint_id": "ep_d6f7a717b7c21d7e9605ea7cfcac85d2",
"method": "GET",
"username": "" // 请填写实际值,
"birthday": "" // 请填写实际值,
"hour": "" // 请填写实际值,
"sex": "" // 请填写实际值
}'
浙公网安备 33059102000262号