老黄历API提供指定日期的黄历信息查询,包含干支、宜忌、冲煞、时辰吉凶等完整数据。
| Header名称 | 默认值 | 必填 | 说明 |
|---|---|---|---|
X-API-Key |
你的API密钥
|
是 | 逗号APIKEY,用户后台首页获取 |
Content-Type |
application/json
|
是 | 请求内容类型 |
| 参数名 | 默认值 | 必填 | 说明 |
|---|---|---|---|
api_id |
16 |
是 | API接口ID,系统默认 |
endpoint_id |
ep_c6f67706125a859b1ad1cda4b0138919 |
是 | 端点ID,系统默认 |
method |
POST |
是 | 请求方式,可选值:GET,POST |
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
date |
string | 否 | 查询日期,格式YYYY-MM-DD,默认当天 | |
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
data.date |
string | 查询日期(YYYY-MM-DD) | |
data.solar.year |
integer | 公历年份 | |
data.solar.month |
integer | 公历月份 | |
data.solar.day |
integer | 公历日期 | |
data.solar.week |
string | 星期(星期一~星期日) | |
data.lunar.year |
integer | 农历年份 | |
data.lunar.month |
integer | 农历月份(负数表示闰月) | |
data.lunar.day |
integer | 农历日期 | |
data.lunar.display |
string | 农历显示文本(如"农历六月十六") | |
data.ganzhi.year |
string | 年干支(如"丙午") | |
data.ganzhi.month |
string | 月干支(如"乙未") | |
data.ganzhi.day |
string | 日干支(如"乙亥") | |
data.animal |
string | 生肖(鼠/牛/虎/兔/龙/蛇/马/羊/猴/鸡/狗/猪) | |
data.constellation |
string | 星座(白羊座~双鱼座) | |
data.wuxing |
string | 当日五行属性(金/木/水/火/土) | |
data.jieqi |
string | 当前所处节气 | |
data.star28 |
string | 二十八星宿(角/亢/氐/房/心/尾/箕...) | |
data.jianchu |
string | 十二建除(建/除/满/平/定/执/破/危/成/收/开/闭) | |
data.zhishen.name |
string | 值神名称(青龙/明堂/天刑/朱雀/金匮/天德/白虎/玉堂/天牢/玄武/司命/勾陈) | |
data.zhishen.type |
string | 值神类型("黄道"或"黑道") | |
data.kongming |
string | 孔明六耀(先胜/先负/友引/佛灭/大安/赤口) | |
data.yiji.yi |
array | 宜事宜项列表 | |
data.yiji.ji |
array | 忌事宜项列表 | |
data.chongsha.animal |
string | 冲煞生肖 | |
data.chongsha.zhi |
string | 冲煞地支 | |
data.chongsha.sha |
string | 煞方(东/南/西/北) | |
data.caishen |
string | 财神、福神、喜神方位 | |
data.taishen |
string | 胎神方位 | |
data.pengzu |
string | 彭祖百忌 | |
data.rilu |
string | 日禄信息 | |
data.festivals |
array | 节日列表(包含阳历节日和农历节日) | |
data.shichen[].hour |
integer | 时辰序号(0=子时, 1=丑时, ..., 11=亥时) | |
data.shichen[].hourName |
string | 时辰名称(子时/丑时/寅时...) | |
data.shichen[].timeRange |
string | 时间范围(如"07:00-08:59") | |
data.shichen[].ganzhi |
string | 时辰干支(如"丙子") | |
data.shichen[].zhishen |
string | 时辰值神名称 | |
data.shichen[].zhishenType |
string | 时辰值神类型("黄道"或"黑道") | |
data.shichen[].yi |
array | 时辰宜事 | |
data.shichen[].ji |
array | 时辰忌事 | |
data.shichen[].chong |
string | 时辰冲煞生肖(如"冲马") | |
data.shichen[].sha |
string | 时辰煞方(如"煞南") | |
data.shichen[].isRiPo |
boolean | 是否日时相冲(true=日时相冲,诸事不宜) | |
data.shichen[].isRiPoDesc |
string | 日时相冲说明文字 | |
generated_at |
string | 数据生成时间(YYYY-MM-DD HH:MM:SS) | |
data.zibai |
array | 紫白九星 | |
data.jishen |
array | 吉神列表 | |
data.xiongsha |
array | 凶煞列表 | |
{"success":true,"data":{"date":"2026-07-07","solar":{"year":"2026","month":"7","day":"7","week":"星期二"},"lunar":{"year":"2026","month":5,"day":23,"display":"农历五月廿三"},"ganzhi":{"year":"丙午","month":"戊申","day":"壬午"},"animal":"马","constellation":"巨蟹座","jieqi":"小暑(月建:未)","star28":"觜宿","jianchu":"闭","zhishen":{"name":"天牢","type":"黑道"},"kongming":"先负","zibai":"九紫","jishen":["天德","月德"],"xiongsha":["天牢","五虚"],"yiji":{"yi":["祭祀","祈福","入殓","除服","成服","移柩","破土","启钻","塞穴","断蚁","结网"],"ji":["嫁娶","开市","入宅","安床","动土","建造","开光","盖屋"]},"chongsha":{"animal":"鼠","zhi":"子","sha":"北"},"caishen":"财神:正南、福神:东南、喜神:正南","taishen":"房床碓外正南","pengzu":"壬不汲水 午不苫盖","rilu":"亥命互禄","wuxing":"水","festivals":["小暑"],"shichen":[{"hour":0,"hourName":"子时","timeRange":"00:00-00:59","ganzhi":"庚子","zhishen":"天牢","zhishenType":"黑道","yi":["无"],"ji":["日时相冲,诸事不宜"],"chong":"冲马","sha":"煞南","isRiPo":true,"isRiPoDesc":"日时相冲,诸事不宜"},{"hour":1,"hourName":"丑时","timeRange":"01:00-02:59","ganzhi":"辛丑","zhishen":"玄武","zhishenType":"黑道","yi":["求嗣","嫁娶","移徙","入宅"],"ji":["赴任","出行","修造","动土"],"chong":"冲羊","sha":"煞东","isRiPo":false,"isRiPoDesc":""},{"hour":2,"hourName":"寅时","timeRange":"03:00-04:59","ganzhi":"壬寅","zhishen":"司命","zhishenType":"黄道","yi":["祈福","求嗣","订婚","嫁娶","安神"],"ji":["上梁","盖屋","入殓"],"chong":"冲猴","sha":"煞北","isRiPo":false,"isRiPoDesc":""},{"hour":3,"hourName":"卯时","timeRange":"05:00-06:59","ganzhi":"癸卯","zhishen":"勾陈","zhishenType":"黑道","yi":["作灶","祭祀","斋醮","酬神"],"ji":["赴任","出行","修造","远行"],"chong":"冲鸡","sha":"煞西","isRiPo":false,"isRiPoDesc":""},{"hour":4,"hourName":"辰时","timeRange":"07:00-08:59","ganzhi":"甲辰","zhishen":"青龙","zhishenType":"黄道","yi":["祈福","订婚","嫁娶","安床"],"ji":["上梁","盖屋","入殓"],"chong":"冲狗","sha":"煞南","isRiPo":false,"isRiPoDesc":""},{"hour":5,"hourName":"巳时","timeRange":"09:00-10:59","ganzhi":"乙巳","zhishen":"明堂","zhishenType":"黄道","yi":["祭祀","斋醮","酬神","修造","作灶"],"ji":["赴任","词讼"],"chong":"冲猪","sha":"煞东","isRiPo":false,"isRiPoDesc":""},{"hour":6,"hourName":"午时","timeRange":"11:00-12:59","ganzhi":"丙午","zhishen":"天刑","zhishenType":"黑道","yi":["嫁娶","移徙","入宅","开市"],"ji":["赴任","词讼","祈福","求嗣"],"chong":"冲鼠","sha":"煞北","isRiPo":false,"isRiPoDesc":""},{"hour":7,"hourName":"未时","timeRange":"13:00-14:59","ganzhi":"丁未","zhishen":"朱雀","zhishenType":"黑道","yi":["求嗣","订婚","嫁娶","修造"],"ji":["祭祀","祈福","斋醮","酬神"],"chong":"冲牛","sha":"煞西","isRiPo":false,"isRiPoDesc":""},{"hour":8,"hourName":"申时","timeRange":"15:00-16:59","ganzhi":"戊申","zhishen":"金匮","zhishenType":"黄道","yi":["修造","动土","开市","求财"],"ji":[],"chong":"冲虎","sha":"煞南","isRiPo":false,"isRiPoDesc":""},{"hour":9,"hourName":"酉时","timeRange":"17:00-18:59","ganzhi":"己酉","zhishen":"天德","zhishenType":"黄道","yi":["祭祀","祈福","斋醮","酬神","求嗣"],"ji":[],"chong":"冲兔","sha":"煞东","isRiPo":false,"isRiPoDesc":""},{"hour":10,"hourName":"戌时","timeRange":"19:00-20:59","ganzhi":"庚戌","zhishen":"白虎","zhishenType":"黑道","yi":["求嗣","订婚","嫁娶","开市"],"ji":["赴任","出行","求财","祭祀"],"chong":"冲龙","sha":"煞北","isRiPo":false,"isRiPoDesc":""},{"hour":11,"hourName":"亥时","timeRange":"21:00-22:59","ganzhi":"辛亥","zhishen":"玉堂","zhishenType":"黄道","yi":["修造","盖屋","移徙","安床"],"ji":["祭祀","祈福","斋醮","开光"],"chong":"冲蛇","sha":"煞西","isRiPo":false,"isRiPoDesc":""}]},"generated_at":"2026-07-31 22:53:17"}
{"success":false,"error":"invalid_date","message":"日期格式错误,请使用YYYY-MM-DD格式"}
| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
400 |
400 | invalid_date | 日期格式错误 |
405 |
405 | method_not_allowed | 仅支持GET |
| 错误代码 | 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平台不承担任何相关责任。
<?php
// 以 老黄历日历详版(ID:16) 为例,以下为PHP请求示例:
$gateway_url = "https://api.douhao.com/gateway";
// 系统参数
$gatewayData = array(
'api_id' => 16,
'endpoint_id' => 'ep_c6f67706125a859b1ad1cda4b0138919',
'method' => 'GET,POST'
);
// 业务参数(请填写实际值)
$bizParams = array(
'date' => '', // 请填写实际值
);
// 合并请求数据
$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': 16,
'endpoint_id': 'ep_c6f67706125a859b1ad1cda4b0138919',
'method': 'GET,POST'
}
# 业务参数(请填写实际值)
biz_params = {
'date': '', # 请填写实际值
}
# 合并请求参数
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:16) 为例,以下为Node.js请求示例
// 需要先安装 axios: npm install axios
const axios = require('axios');
// API网关地址
const gatewayUrl = 'https://api.douhao.com/gateway';
// 系统参数
const gatewayData = {
api_id: 16,
endpoint_id: 'ep_c6f67706125a859b1ad1cda4b0138919',
method: 'GET,POST'
};
// 业务参数(请填写实际值)
const bizParams = {
"date": "", // 请填写实际值
};
// 合并请求参数
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:16) 为例,以下为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", 16);
gatewayData.put("endpoint_id", "ep_c6f67706125a859b1ad1cda4b0138919");
gatewayData.put("method", "GET,POST");
// 业务参数(请填写实际值)
Map<String, Object> bizParams = new HashMap<>();
map.put("date", ""); // 请填写实际值
// 合并请求数据
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:16) 为例,以下为cURL请求示例
curl -X POST "https://api.douhao.com/gateway" \
-H "Content-Type: application/json" \
-H "X-API-Key: 您的API密钥" \
-d '{
"api_id": 16,
"endpoint_id": "ep_c6f67706125a859b1ad1cda4b0138919",
"method": "GET,POST",
"date": "" // 请填写实际值
}'
浙公网安备 33059102000262号