出生日期查询API接口

支持公历/农历出生日期查询星座、生肖、生辰八字等信息

返回西方星座、中国生肖、农历转换、八字命理等全维度数据

精准节气分界，子初换日规则，专业命理算法

毫秒级响应，支持高并发/批量查询

套餐灵活，按次计费，无最低消费

7*24小时技术支持，快速解决问题

适用于命理测算、运势分析、用户画像等场景

出生日期查询API接口价格套餐

入门版

¥30.00

10000/天

西方星座基础查询
中国生肖基础识别
响应速度 ≤300ms
基础技术支持
查询记录统计
农历转换功能
生辰八字计算

标准版

¥199.00

100000/天

西方星座精准查询
中国生肖+干支年识别
公历/农历互转功能
响应速度 ≤100ms
7×12小时技术支持
基础生辰八字计算
批量查询功能

企业版

¥999.00

无限次数

全维度命理信息查询
节气分界精准计算
高并发支持（1万次/秒）
响应速度 ≤50ms
7×24小时技术支持
批量出生日期查询接口
定制化数据返回格式

核心功能

西方星座精准查询

支持12星座精准匹配，按实际出生日期计算
返回星座名称、元素属性（火/土/风/水）、日期范围
精准到具体时分的星座分界计算
兼容不同年份的星座日期微调

中国生肖与干支

精准识别十二生肖（鼠/牛/虎/兔等）
计算干支年份（如：丁丑、戊寅）
按春节分界计算生肖，而非公历1月1日
支持1900-2100年全范围生肖查询

农历公历转换

公历转农历，返回农历年月日、闰月信息
农历转公历，支持闰月日期准确转换
返回农历月份名称（正月/二月等）和日期名称
基于高精度农历算法，误差率为0

生辰八字计算

计算年柱、月柱、日柱、时柱，完整八字
精准节气分界，而非简单按月份计算月柱
支持子初换日规则（23点后算次日）
返回日主、五行属性等核心命理信息

易集成开发

多语言支持：PHP、Java、Python、Node.js、C#等主流语言
RESTful接口设计，调用方式简单，5分钟快速集成
支持JSON/XML等多种数据返回格式
完善的错误码体系，便于问题排查

产品优势

算法精准：基于天文历法和传统命理，计算准确率100%
数据全面：覆盖星座、生肖、农历、八字等全维度信息
成本极低：按次计费，无年费/服务费，调用越多单价越低
高可用性：99.99%服务可用性，保障业务连续性
免备案：接口直接调用，无需复杂流程，即开即用

应用场景

命理测算

为命理网站、APP提供精准的星座、生肖、八字计算功能，提升用户体验。

运势分析

结合星座、生肖信息，为用户提供个性化的每日/每月/每年运势分析。

用户画像

统计用户星座、生肖分布，为产品迭代、市场拓展、精准营销提供数据支撑。

个性化服务

根据用户出生日期和星座信息，提供个性化的推荐、祝福、礼品建议等服务。

接口介绍

出生日期查询API为开发者提供全维度的出生日期命理信息查询能力，支持西方星座、中国生肖、农历转换、生辰八字等信息精准计算，基于高精度天文历法算法，毫秒级响应，适用于命理测算、运势分析、用户画像等各类应用场景，接口兼容PHP、Java、Python、Node.js等主流开发语言。

接口地址

出生日期查询接口：http://api.41game.com/data/calendar.php

请求方式：GET/POST（推荐POST）

编码格式：UTF-8

返回格式：JSON/XML（默认JSON）

出生日期查询请求参数

参数名	必填	类型	说明
calendar	是	string	历法类型：solar(公历) / lunar(农历)
year	是	int	年份（如：1997）
month	是	int	月份（1-12）
day	是	int	日期（1-31）
time	否	string	时间（格式：HH:MM，如：21:10），默认00:00
dayBoundary	否	string	日界规则：z(子初换日) / m(午夜换日)，默认z
key	是	string	在聚合数据申请的接口密钥

返回参数

参数名	类型	说明
success	boolean	请求是否成功，true/false
data	object	返回结果对象
data.input	object	输入信息
data.input.birthDateTime	string	出生日期时间（格式：YYYY-MM-DD HH:MM:SS）
data.input.timezone	string	时区信息
data.input.timestamp	number	时间戳（毫秒）
data.westernZodiac	object	西方星座信息
data.westernZodiac.name	string	星座名称（如：天蝎座）
data.westernZodiac.element	string	星座元素（如：水象）
data.westernZodiac.dateRange	string	星座日期范围
data.chineseZodiac	object	中国生肖信息
data.chineseZodiac.animal	string	生肖（如：牛）
data.chineseZodiac.lunarYear	number	农历年份
data.chineseZodiac.ganZhiYear	string	干支年份（如：丁丑）
data.lunarDate	object	农历日期信息
data.bazi	object	生辰八字信息
data.bazi.eightCharacters	string	完整八字（如：丁丑辛亥戊午癸亥）
data.meta	object	元数据信息

错误码说明

错误码	说明	解决方式
208001	日期格式错误	检查年月日是否为有效日期
208002	接口密钥错误	核对平台申请的API Key是否正确
208003	调用次数不足	前往平台充值购买调用次数
208004	请求频率超限	降低调用频率，或升级套餐
208005	年份超出范围	仅支持1900-2100年的日期查询

PHP调用示例

<?php // 配置参数 $key = "你的接口密钥"; $calendar = "solar"; $year = 1997; $month = 11; $day = 12; $time = "21:10"; $dayBoundary = "z"; // 拼接请求URL $url = "http://api.41game.com/birth/analysis?key={$key}&calendar={$calendar}&year={$year}&month={$month}&day={$day}&time={$time}&dayBoundary={$dayBoundary}"; // 发起请求 $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); $response = curl_exec($ch); curl_close($ch); // 解析结果 $result = json_decode($response, true); if($result['success']){ echo "查询成功："; echo "西方星座：".$result['data']['westernZodiac']['name']; echo "中国生肖：".$result['data']['chineseZodiac']['animal']; echo "生辰八字：".$result['data']['bazi']['eightCharacters']; }else{ echo "查询失败"; } ?>

Python调用示例

import requests # 配置参数 key = "你的接口密钥" calendar = "solar" year = 1997 month = 11 day = 12 time = "21:10" dayBoundary = "z" # 拼接请求URL url = f"http://api.41game.com/birth/analysis?key={key}&calendar={calendar}&year={year}&month={month}&day={day}&time={time}&dayBoundary={dayBoundary}" # 发起请求 response = requests.get(url) result = response.json() # 解析结果 if result['success']: print(f"西方星座：{result['data']['westernZodiac']['name']}") print(f"星座元素：{result['data']['westernZodiac']['element']}") print(f"中国生肖：{result['data']['chineseZodiac']['animal']}") print(f"干支年份：{result['data']['chineseZodiac']['ganZhiYear']}") print(f"生辰八字：{result['data']['bazi']['eightCharacters']}") else: print("查询失败")

Java调用示例

import java.io.BufferedReader; import java.io.InputStreamReader; import java.net.HttpURLConnection; import java.net.URL; public class BirthApiDemo { public static void main(String[] args) { try { // 配置参数 String key = "你的接口密钥"; String calendar = "solar"; int year = 1997; int month = 11; int day = 12; String time = "21:10"; String dayBoundary = "z"; // 拼接请求URL String urlStr = String.format( "http://api.41game.com/birth/analysis?key=%s&calendar=%s&year=%d&month=%d&day=%d&time=%s&dayBoundary=%s", key, calendar, year, month, day, time, dayBoundary ); // 发起请求 URL url = new URL(urlStr); HttpURLConnection conn = (HttpURLConnection) url.openConnection(); conn.setRequestMethod("GET"); conn.setConnectTimeout(5000); conn.setReadTimeout(5000); // 读取响应 BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream())); String line; StringBuilder response = new StringBuilder(); while ((line = in.readLine()) != null) { response.append(line); } in.close(); // 输出结果 System.out.println("接口返回结果：" + response.toString()); } catch (Exception e) { e.printStackTrace(); } } }

返回示例（成功）

{ "success": true, "data": { "input": { "birthDateTime": "1997-11-12 21:10:00", "timezone": "Asia/Shanghai (UTC+08:00)", "timestamp": 879340200000 }, "westernZodiac": { "name": "天蝎座", "element": "水象", "dateRange": "10/24-11/22" }, "chineseZodiac": { "animal": "牛", "lunarYear": 1997, "ganZhiYear": "丁丑" }, "lunarDate": { "year": 1997, "monthNumber": 10, "monthName": "十月", "dayNumber": 13, "dayName": "十三", "isLeapMonth": false }, "bazi": { "yearPillar": "丁丑", "monthPillar": "辛亥", "dayPillar": "戊午", "hourPillar": "癸亥", "eightCharacters": "丁丑辛亥戊午癸亥", "dayMaster": "戊", "dayBoundary": "zi", "convention": "子初换日（23:00-00:59 视作次日）", "seasonBoundary": { "previous": { "solarTerm": "立冬", "monthNumber": 10, "dateTimeCST": "1997-11-08 00:30:19" }, "next": { "solarTerm": "大雪", "monthNumber": 11, "dateTimeCST": "1997-12-07 16:47:19" } } }, "meta": { "rawInput": "21:10", "dayBoundary": "zi", "calendar": "solar", "convertedSolarDate": "1997-11-12 21:10:00", "resolvedIsLeapMonth": null, "lunarResolution": null } } }

返回示例（失败）

{ "success": false, "error": { "code": 208001, "message": "日期格式错误：月份必须在1-12之间" } }

计费规则

按实际成功调用次数计费，调用失败（success=false）不计费
单条查询：每次查询1个出生日期，计1次调用
批量查询：单次提交N个出生日期，成功查询M个则计M次调用
购买的调用次数有效期为12个月，过期未使用自动失效
支持预充值和后付费两种结算方式（企业版专属）

常见问题

Q1：调用失败是否计费？

答：不计费。我们仅对调用成功（success=true）的请求进行计费，您可以在后台查看详细的调用记录和计费明细。

Q2：购买的调用次数可以退款吗？

答：充值购买的调用次数一旦生效，不支持退款。但可转让给同主体下的其他账号使用。

Q3：如何升级套餐？

答：您可以在后台直接升级套餐，差价多退少补。升级后立即享受新套餐的单价和服务权益。

Q4：农历日期可以查询吗？

答：标准版及以上套餐支持农历日期查询和转换，入门版仅支持公历日期查询。