| Header名称 | 默认值 | 必填 | 说明 |
|---|---|---|---|
X-API-Key |
你的API密钥
|
是 | 逗号APIKEY,用户后台首页获取 |
Content-Type |
application/json
|
是 | 请求内容类型 |
| 参数名 | 默认值 | 必填 | 说明 |
|---|---|---|---|
api_id |
35 |
是 | API接口ID,系统默认 |
endpoint_id |
ep_488b58719e2387dec2cd9836dd5d8887 |
是 | 端点ID,系统默认 |
method |
POST |
是 | 请求方式,可选值:GET,POST |
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
name |
string | 是 | 姓名 | |
birthday |
string | 是 | 出生日期,格式为 YYYY-MM-DD | |
hour |
string | 是 | 出生时辰,为0-23的整数 | |
sex |
string | 是 | 性别,1 代表男性,0 代表女性 | |
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
code |
string | 业务状态码,1 表示查询成功 | |
msg |
string | 返回信息,如"查询成功" | |
time |
string | 响应时间戳(Unix时间戳) | |
data |
string | 核心测算数据对象 | |
其他参数见接口详情 |
string | 其他参数见接口详情 | |
{"code":1,"msg":"查询成功","data":{"name":"张三","xs":"张","mz":"三","birthday":{"year":"2006","month":"07","day":"07","hour":"11"},"sex":"男","lunar":"二零零六年六月十二11:00-11:59 午时","score":42,"sancai":"## 您的名字:张三,总之家庭不幸者居多。如人格部为24数,则多温顺有智谋,易发财,可得权利名誉等幸运。","wuxing":{"j":1,"m":1,"s":0,"h":4,"t":2,"b":"火金","k":"木水土","w":"火","q":"水","o":null},"bazi":{"nayin":[{"id":"23","jiazi":"丙戌","layin":"屋上土","whsx":{"sx":"自眠之狗","wh":"屋上土","sx_py":"gou","wh_py":"tu","wx_py":"火土"}},{"id":"32","jiazi":"乙未","layin":"沙中金","whsx":{"sx":"敬重之羊","wh":"沙中金","sx_py":"yang","wh_py":"jin","wx_py":"木土"}},{"id":"34","jiazi":"丁酉","layin":"山下火","whsx":{"sx":"独立之鸡","wh":"山下火","sx_py":"ji","wh_py":"huo","wx_py":"火金"}},{"id":"43","jiazi":"丙午","layin":"天河水","whsx":{"sx":"行路之马","wh":"天河水","sx_py":"ma","wh_py":"shui","wx_py":"火火"}}],"tywh":{"wh":"火","tnwh":"火木","ynwh":"水金土","skzhyj":"火旺得水,方成相济。\r火能生土,土多火晦;强火得土,方止其焰。\r火能克金,金多火熄;金弱遇火,必见销熔。\r火赖木生,木多火炽;木能生火,火多木焚。","whzx":"火主礼,其性急,其情恭,其味苦,其色赤。火盛之人头小脚长,上尖下阔,浓眉小耳,精神闪烁,为人谦和恭敬,纯朴急躁。火衰之人则黄瘦尖楞,语言妄诞,诡诈妒毒,做事有始无终。","szwh":"心脏与小肠互为脏腑表里,又属血脉及整个循环系统。过旺或过衰,较宜患小肠,心脏,肩,血液,经血,脸部,牙齿,腹部,舌部等方面的疾病。","hyhw":"宜火者,喜南方。可从事放光,照明,光学,高热,易燃,油类,酒精类,热饮食,食品,理发,化妆品,人身装饰品,文艺,文学,文具,文化学生,文人,作家,写作,撰文,教员,校长,秘书,出版,公务,正界等方面的经营和事业。"}},"youquedian":"","syfx":"丁字有“烛灯”的暗示,所以2022年您的还是口风严谨些,与朋友聊天注意一些。","xm_arr":{"xing1":"张","xing1py":"zhang","xing1gb":"張","xing2":null,"xing2py":null,"xing2gb":null,"ming1":"三","ming1py":"san","ming1gb":"三","ming2":null,"ming2py":null,"ming2gb":null},"bh_wh_arr":{"bihua1":"11","bihua2":null,"bihua3":"3","bihua4":null,"hzwh1":"火","hzwh2":null,"hzwh3":"金","hzwh4":null},"tdr_ge":{"renge":14,"tiange":12,"dige":4,"tian_sancai":"木","ren_sancai":"火","di_sancai":"火","waige":2,"waige_sancai":"木","zhongge":14,"zongge_sancai":"火"},"rssancai":{"title":"木火火","yy":"得顺调成功发展,但有缺乏耐久力的缺点,或依靠性太强,招失败,有陷入失意病弱之兆。","jx":"平","content":"1、总论:虽有成功运,但不甘寂寞,忍耐力不够,容易一意孤行,陷入孤军奋斗,如能修身养性,定能成功顺调。名利双利,若天运五行属水,青年时代事业难成又逢灾,老运亦欠佳。\n2、性格:外表乐观而豪爽,交际应酬有一套,人缘又好,但个性喜怒无常,感情易热易冷,个性急燥,容易意气用事。\n3、意志:意志尚称坚定,可依自己的理想和努力,达到成功成名,但不耐寂寞独处生活。\n4、事业:做事冲动而积极,很容易功成名就,一展自己的抱负。\n5、家庭:夫妻美满,子女孝顺,但应节制应酬才能保持长久。\n6、姓名测试爱情:男娶热情直率之妻,应减少应酬风流之事;女嫁温厚谦恭之夫,要减少让丈夫多疑之行为。\n7、子女:男孩多于女孩,每个都健康活泼,稍嫌调皮,长大后都能获得相当成就。\n8、社交:人缘很好,朋友很多,易与异性接触,避免桃色事件发生。\n9、精神:外表乐观,内在则脾气暴,常自找精神上的负担。\n10、财运:物质不缺,财源广进,富贵之格。\n11、健康:注意血压过高或心脏病。\n12、老运:可享受晚年,但恐缺天份之乐。","jcy":"可得一时的吉运,但基础薄弱,缺乏耐久力。","jx1":"但天格为1或2时吉利。","cgy":"受上级长辈的照顾关心,能顺利成功发达。","jx2":"吉","rjgx":"有财,男命妻家富足而受福荫,成功顺利,富有社交吸引力,受人扶持,贵人相助而成大气候。","jx3":"吉","xg":"其内具爆发性的品质,表面却极平稳。如火燃湿木一样,虽起初烟而不能成火象,往往有抑制心思,不敢告诉他人的性格,表面矛盾,徒耗精力。擅长手腕,长于舌辩。有虚伪、多曲折者;有病弱、短命、家属子女缘薄者,总之家庭不幸者居多。如人格部为24数,则多温顺有智谋,易发财,可得权利名誉等幸运。"}},"time":1785667869}
{"code":0,"msg":"请提供姓名参数(uname)","data":null,"time":1785667835}
| 错误代码 | 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表示成功,0表示失败 |
| msg | string | 返回消息,如"查询成功" |
| data | object | 八字精批核心数据对象 |
| time | int | 数据生成时间戳(Unix时间戳) |
| 字段 | 类型 | 说明 |
|---|---|---|
| name | string | 姓名 |
| xs | string | 姓氏 |
| mz | string | 名字 |
| sex | string | 性别(男/女) |
| score | int | 综合评分(0-100) |
| lunar | string | 农历日期(如"二零零六年六月十二") |
| 字段 | 类型 | 说明 |
|---|---|---|
| year | int | 公历年份 |
| month | int | 公历月份 |
| day | int | 公历日期 |
| hour | int | 出生小时(0-23) |
| 字段 | 类型 | 说明 |
|---|---|---|
| xing1 | string | 姓氏(简体) |
| xing1py | string | 姓氏拼音 |
| xing1gb | string | 姓氏繁体 |
| xing2 | string|null | 复姓第二字(单姓为null) |
| ming1 | string | 名字第一字(简体) |
| ming1py | string | 名字第一字拼音 |
| ming1gb | string | 名字第一字繁体 |
| ming2 | string|null | 名字第二字(单名为null) |
| 字段 | 类型 | 说明 |
|---|---|---|
| bihua1 | string | 姓氏笔画数 |
| bihua2 | string|null | 复姓第二字笔画 |
| bihua3 | string | 名字第一字笔画数 |
| bihua4 | string|null | 名字第二字笔画 |
| hzwh1 | string | 姓氏汉字五行(金/木/水/火/土) |
| hzwh2 | string|null | 复姓第二字五行 |
| hzwh3 | string | 名字第一字五行 |
| hzwh4 | string|null | 名字第二字五行 |
| 字段 | 类型 | 说明 |
|---|---|---|
| j | int | 金字个数 |
| m | int | 木字个数 |
| s | int | 水字个数 |
| h | int | 火字个数 |
| t | int | 土字个数 |
| b | string | 补益五行(喜用神) |
| k | string | 克泄五行(忌神) |
| w | string | 旺盛五行 |
| q | string | 缺失五行 |
| o | int | 五行种类数 |
| 字段 | 类型 | 说明 |
|---|---|---|
| tiange | int | 天格数 |
| renge | int | 人格数 |
| dige | int | 地格数 |
| waige | int | 外格数 |
| zhongge | int | 总格数 |
| tian_sancai | string | 天格三才五行 |
| ren_sancai | string | 人格三才五行 |
| di_sancai | string | 地格三才五行 |
| waige_sancai | string | 外格三才五行 |
| zongge_sancai | string | 总格三才五行 |
| 字段 | 类型 | 说明 |
|---|---|---|
| title | string | 三才配置名称(如"金木土") |
| yy | string | 三才要义/总评 |
| jx | string | 三才吉凶(吉/凶/小吉/下吉等) |
| content | string | 三才详细分析(12项分论) |
| jcy | string | 基础运描述 |
| jx1 | string | 基础运吉凶 |
| cgy | string | 成功运描述 |
| jx2 | string | 成功运吉凶 |
| rjgx | string | 人际关系描述 |
| jx3 | string | 人际关系吉凶 |
| xg | string | 性格描述 |
注:data.sancai 字段为该模块的Markdown富文本版本,适合直接渲染展示。
| 字段 | 类型 | 说明 |
|---|---|---|
| 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 | 五行加权分数({"金":19,"木":11,...}) |
| 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 | 干支五行拼音 |
| 字段 | 类型 | 说明 |
|---|---|---|
| wh | string | 日主五行 |
| tnwh | string | 同类五行(帮扶日主的五行) |
| ynwh | string | 异类五行(克泄耗日主的五行) |
| skzhyj | string | 五行生克制化宜忌 |
| whzx | string | 五行之性(性格特征) |
| szwh | string | 五行脏腑健康提示 |
| hyhw | string | 宜从事行业与方位 |
| 字段 | 类型 | 说明 |
|---|---|---|
| syfx | string | 事业分析 / 日主特性与职业方向 |
| waigearr | string | 性格分析 / 外在表现(含幸运数字、健康、建议) |
| yearyunshi | string | 流年运势分析(事业/财运/感情/健康/贵人等) |
| youquedian | string | 优缺点分析(可能为空字符串) |
<?php
// 以 八字精批(ID:35) 为例,以下为PHP请求示例:
$gateway_url = "https://api.douhao.com/gateway";
// 系统参数
$gatewayData = array(
'api_id' => 35,
'endpoint_id' => 'ep_488b58719e2387dec2cd9836dd5d8887',
'method' => 'GET,POST'
);
// 业务参数(请填写实际值)
$bizParams = array(
'name' => '', // 请填写实际值,
'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': 35,
'endpoint_id': 'ep_488b58719e2387dec2cd9836dd5d8887',
'method': 'GET,POST'
}
# 业务参数(请填写实际值)
biz_params = {
'name': '', # 请填写实际值,
'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:35) 为例,以下为Node.js请求示例
// 需要先安装 axios: npm install axios
const axios = require('axios');
// API网关地址
const gatewayUrl = 'https://api.douhao.com/gateway';
// 系统参数
const gatewayData = {
api_id: 35,
endpoint_id: 'ep_488b58719e2387dec2cd9836dd5d8887',
method: 'GET,POST'
};
// 业务参数(请填写实际值)
const bizParams = {
"name": "", // 请填写实际值,
"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:35) 为例,以下为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", 35);
gatewayData.put("endpoint_id", "ep_488b58719e2387dec2cd9836dd5d8887");
gatewayData.put("method", "GET,POST");
// 业务参数(请填写实际值)
Map<String, Object> bizParams = new HashMap<>();
map.put("name", ""); // 请填写实际值
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:35) 为例,以下为cURL请求示例
curl -X POST "https://api.douhao.com/gateway" \
-H "Content-Type: application/json" \
-H "X-API-Key: 您的API密钥" \
-d '{
"api_id": 35,
"endpoint_id": "ep_488b58719e2387dec2cd9836dd5d8887",
"method": "GET,POST",
"name": "" // 请填写实际值,
"birthday": "" // 请填写实际值,
"hour": "" // 请填写实际值,
"sex": "" // 请填写实际值
}'
浙公网安备 33059102000262号