

| Header名称 | 默认值 | 必填 | 说明 |
|---|---|---|---|
X-API-Key | 你的API密钥 | 是 | 逗号APIKEY,用户后台首页获取 |
Content-Type | application/json | 是 | 请求内容类型 |
| 参数名 | 默认值 | 必填 | 说明 |
|---|---|---|---|
api_id | 60 | 是 | API接口ID,系统默认 |
endpoint_id | ep_45d63f4f422b4ac7ccef3fba49ba54a4 | 是 | 端点ID,系统默认 |
method | POST | 是 | 请求方式,可选值:GET,POST |
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
ownerName | string | 是 | 业主一姓名 | |
ownerBirthday | string | 是 | 业主一生日,格式 YYYY-MM-DD | |
ownerHour | integer | 是 | 业主一出生时辰(0-23 整数) | |
owner2Name | string | 否 | 业主二姓名(可选,若填须同时填生日和时辰) | |
owner2Birthday | string | 否 | 业主二生日,格式 YYYY-MM-DD | |
owner2Hour | integer | 否 | 业主二出生时辰(0-23 整数) | |
range | string | 否 | 时间范围:1month(默认)、3months、6months、1year | |
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
返回参数见接口详情 | string | 返回参数见接口详情 | |
{"success":true,"data":{"persons":[{"name":"李华","birthday":"2006-07-07","hour":1,"bazi":"丙戌 乙未 丁酉 辛丑","animal":"狗","nayin":"山下火","avoid":{"zhi":"辰","animal":"龙","sha":"北"}}],"range":{"start":"2026-09-12","end":"2026-10-12","range":"1month"},"goodDays":[{"date":"2026-09-17","lunar":{"lunarYear":"2026","lunarMonth":8,"lunarDay":7},"dayGZ":"甲午","chong":{"zhi":"子","animal":"鼠","sha":"北"},"yi":["祭祀","祈福","建造","纳采","订盟","搬家","出行","斋醮","塑绘","开光","安香","出火","会亲友","解除","入学","竖柱","上梁","拆卸","盖屋","起基","栽种","牧养","纳畜"],"ji":["开市","安床","动土","裁衣","安葬","破土","开仓","出货财","启钻"],"zhiShen":{"name":"金匮","type":"黄道"},"star":{"name":"箕宿","yi":["建造","祭祀","祈福"],"ji":["嫁娶","开市","入宅","安床","动土","裁衣"]},"jianChu":"收","caishen":"财神:东北、福神:正北、喜神:东北","taishen":"房床碓外正南","festivals":[]},{"date":"2026-09-29","lunar":{"lunarYear":"2026","lunarMonth":8,"lunarDay":19},"dayGZ":"丙午","chong":{"zhi":"子","animal":"鼠","sha":"北"},"yi":["祭祀","祈福","纳采","订盟","搬家","出行","斋醮","塑绘","开光","安香","出火","会亲友","解除","入学","竖柱","上梁","拆卸","盖屋","起基","栽种","牧养","纳畜"],"ji":["开市","安葬","安床","动土","建造","破土","开仓","出货财","启钻"],"zhiShen":{"name":"金匮","type":"黄道"},"star":{"name":"觜宿","yi":["祭祀","祈福"],"ji":["嫁娶","开市","入宅","安床","动土","建造","安葬"]},"jianChu":"收","caishen":"财神:正西、福神:西北、喜神:西南","taishen":"房床碓外正南","festivals":[]},{"date":"2026-10-10","lunar":{"lunarYear":"2026","lunarMonth":9,"lunarDay":1},"dayGZ":"丁巳","chong":{"zhi":"亥","animal":"猪","sha":"东"},"yi":["开市","纳采","订盟","交易","播种","立券","搬家","入宅","安机械","会亲友","经络","安门","安床","挂匾","拆卸","开仓","出货财","开池","栽种","纳畜","牧养","破土","启钻","移柩","入殓","立碑"],"ji":["远行","建造","祭祀","祈福","探病","谢土","造桥"],"zhiShen":{"name":"明堂","type":"黄道"},"star":{"name":"氐宿","yi":["纳采","订盟","开市","交易","播种"],"ji":["安葬","远行","嫁娶","建造"]},"jianChu":"危","caishen":"财神:正西、福神:东南、喜神:正南","taishen":"仓库炉房内东南","festivals":[]}]},"generated_at":"2026-09-12 09:17:32"}{"success":false,"error":"invalid_name","message":"第1个人物的姓名不能为空"}| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
400 | 400 | invalid_name | 姓名未填写 |
400 | 400 | invalid_birthday | 生日格式错误,请使用 YYYY-MM-DD |
400 | 400 | invalid_hour | 出生时辰未填写或不在 0-23 范围内 |
| 错误代码 | 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平台不承担任何相关责任。
5、所有结果都是依据国学书籍来进行演算,可能部分书籍原始资料有误,若遇到不对的地方,联系客服指正修改!
| 字段 | 类型 | 说明 |
|---|---|---|
| data.persons[0].name | string | 业主一姓名(原样返回) |
| data.persons[0].birthday | string | 业主一生日 |
| data.persons[0].hour | int | 业主一出生时辰 |
| data.persons[0].bazi | string | 业主一四柱八字 |
| data.persons[0].animal | string | 业主一生肖 |
| data.persons[0].nayin | string | 业主一日柱纳音 |
| data.persons[0].avoid.zhi | string | 业主一需避开的地支 |
| data.persons[0].avoid.animal | string | 业主一需避开的生肖 |
| data.persons[0].avoid.sha | string | 业主一需避开的煞方 |
| data.persons[1].name | string | 业主二姓名(原样返回) |
| data.persons[1].birthday | string | 业主二生日 |
| data.persons[1].hour | int | 业主二出生时辰 |
| data.persons[1].bazi | string | 业主二四柱八字 |
| data.persons[1].animal | string | 业主二生肖 |
| data.persons[1].nayin | string | 业主二日柱纳音 |
| data.persons[1].avoid.zhi | string | 业主二需避开的地支 |
| data.persons[1].avoid.animal | string | 业主二需避开的生肖 |
| data.persons[1].avoid.sha | string | 业主二需避开的煞方 |
| 字段 | 类型 | 说明 |
|---|---|---|
| data.range.start | string | 起始日期 YYYY-MM-DD(今天) |
| data.range.end | string | 结束日期 YYYY-MM-DD |
| data.range.range | string | 时间范围标识 |
| 字段 | 类型 | 说明 |
|---|---|---|
| data.goodDays[].date | string | 吉日日期 YYYY-MM-DD |
| data.goodDays[].lunar.lunarYear | int | 农历年 |
| data.goodDays[].lunar.lunarMonth | int | 农历月 |
| data.goodDays[].lunar.lunarDay | int | 农历日 |
| data.goodDays[].dayGZ | string | 当日干支 |
| data.goodDays[].chong.animal | string | 冲煞生肖 |
| data.goodDays[].chong.zhi | string | 冲煞地支 |
| data.goodDays[].chong.sha | string | 煞方 |
| data.goodDays[].yi | array | 宜事列表(老黄历关键词:移徙(已把「移徙」显示为「搬家」)) |
| data.goodDays[].ji | array | 忌事列表(同上替换规则) |
| data.goodDays[].zhiShen.name | string | 值神名称 |
| data.goodDays[].zhiShen.type | string | 值神类型(一定是「黄道」) |
| data.goodDays[].star.name | string | 二十八星宿 |
| data.goodDays[].star.yi | array | 星宿宜事 |
| data.goodDays[].star.ji | array | 星宿忌事 |
| data.goodDays[].jianChu | string | 十二建除 |
| data.goodDays[].caishen | string | 财神/福神/喜神方位 |
| data.goodDays[].taishen | string | 胎神方位 |
| data.goodDays[].festivals | array | 节日列表 |
| data.goodDays[].comment | string | 该日对应类别的六十甲子评语 |
| data.goodDays[].starDesc | string | 该日星宿在该吉日类别下的表现文字 |
<?php
// 以 搬家吉日查询(ID:60) 为例,以下为PHP请求示例:
$gateway_url = "https://api.douhao.com/gateway";
// 系统参数
$gatewayData = array(
'api_id' => 60,
'endpoint_id' => 'ep_45d63f4f422b4ac7ccef3fba49ba54a4',
'method' => 'GET,POST'
);
// 业务参数(请填写实际值)
$bizParams = array(
'ownerName' => '', // 请填写实际值,
'ownerBirthday' => '', // 请填写实际值,
'ownerHour' => '', // 请填写实际值,
'owner2Name' => '', // 请填写实际值,
'owner2Birthday' => '', // 请填写实际值,
'owner2Hour' => '', // 请填写实际值,
'range' => '', // 请填写实际值
);
// 合并请求数据
$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': 60,
'endpoint_id': 'ep_45d63f4f422b4ac7ccef3fba49ba54a4',
'method': 'GET,POST'
}
# 业务参数(请填写实际值)
biz_params = {
'ownerName': '', # 请填写实际值,
'ownerBirthday': '', # 请填写实际值,
'ownerHour': '', # 请填写实际值,
'owner2Name': '', # 请填写实际值,
'owner2Birthday': '', # 请填写实际值,
'owner2Hour': '', # 请填写实际值,
'range': '', # 请填写实际值
}
# 合并请求参数
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:60) 为例,以下为Node.js请求示例
// 需要先安装 axios: npm install axios
const axios = require('axios');
// API网关地址
const gatewayUrl = 'https://api.douhao.com/gateway';
// 系统参数
const gatewayData = {
api_id: 60,
endpoint_id: 'ep_45d63f4f422b4ac7ccef3fba49ba54a4',
method: 'GET,POST'
};
// 业务参数(请填写实际值)
const bizParams = {
"ownerName": "", // 请填写实际值,
"ownerBirthday": "", // 请填写实际值,
"ownerHour": "", // 请填写实际值,
"owner2Name": "", // 请填写实际值,
"owner2Birthday": "", // 请填写实际值,
"owner2Hour": "", // 请填写实际值,
"range": "", // 请填写实际值
};
// 合并请求参数
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:60) 为例,以下为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", 60);
gatewayData.put("endpoint_id", "ep_45d63f4f422b4ac7ccef3fba49ba54a4");
gatewayData.put("method", "GET,POST");
// 业务参数(请填写实际值)
Map<String, Object> bizParams = new HashMap<>();
map.put("ownerName", ""); // 请填写实际值
map.put("ownerBirthday", ""); // 请填写实际值
map.put("ownerHour", ""); // 请填写实际值
map.put("owner2Name", ""); // 请填写实际值
map.put("owner2Birthday", ""); // 请填写实际值
map.put("owner2Hour", ""); // 请填写实际值
map.put("range", ""); // 请填写实际值
// 合并请求数据
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:60) 为例,以下为cURL请求示例
curl -X POST "https://api.douhao.com/gateway" \
-H "Content-Type: application/json" \
-H "X-API-Key: 您的API密钥" \
-d '{
"api_id": 60,
"endpoint_id": "ep_45d63f4f422b4ac7ccef3fba49ba54a4",
"method": "GET,POST",
"ownerName": "" // 请填写实际值,
"ownerBirthday": "" // 请填写实际值,
"ownerHour": "" // 请填写实际值,
"owner2Name": "" // 请填写实际值,
"owner2Birthday": "" // 请填写实际值,
"owner2Hour": "" // 请填写实际值,
"range": "" // 请填写实际值
}'
浙公网安备 33059102000262号