支持1900-2100年完整万年历数据,覆盖阴阳历转换全功能
返回公历/农历/干支/生肖/节气/节日/宜忌/冲煞等完整信息
接口简单易用,支持多种开发语言调用
高精度算法,农历转换准确率100%
套餐灵活,按次计费,无最低消费
7*24小时技术支持,快速解决问题
适用于日历APP、电商平台、政务系统、传统文化应用等场景
10000/天
100000/天
无限次数
为日历APP、小程序、网站等提供精准的阴阳历转换和节日节气信息,丰富产品功能。
根据传统节日、节气等时间节点,智能推荐应季商品,提升营销效果和用户体验。
为政务、企事业单位提供法定节假日安排、工作日判断等功能,辅助考勤和排班管理。
为传统文化类应用提供黄历、择吉、命理等功能,满足用户对传统历法的查询需求。
万年历查询API接口为开发者提供全面的历法查询能力,支持阴阳历转换、节气节日、黄历宜忌、择吉选日等功能,适用于日历应用、电商平台、政务系统、传统文化应用等各类场景,接口兼容PHP、Java、Python、Node.js等主流开发语言。
基础万年历查询接口:http://api.41game.com/calendar/index
黄历查询接口:http://api.41game.com/calendar/lunar
节假日查询接口:http://api.41game.com/calendar/holiday
请求方式:GET/POST
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
| date | 是 | string | 日期(格式:YYYY-MM-DD,如:2024-05-20) |
| type | 否 | int | 返回数据类型,1=基础信息,2=详细信息,3=全部,默认1 |
| key | 是 | string | 在聚合数据申请的接口密钥 |
| dtype | 否 | string | 返回数据格式,支持json/xml,默认json |
| format | 否 | int | 是否格式化返回结果,1=是,0=否,默认0 |
| 参数名 | 类型 | 说明 |
|---|---|---|
| error_code | int | 返回码,0表示成功,非0表示失败 |
| reason | string | 返回说明,成功为"success" |
| result | object | 返回结果对象 |
| result.gregorian | string | 公历日期 |
| result.lunar | string | 农历日期 |
| result.zodiac | string | 生肖 |
| result.stem_branch | string | 干支纪年 |
| result.solar_terms | string | 节气(type=2或3时返回) |
| result.holiday | object | 节假日信息(type=3时返回) |
| result.lucky | array | 黄历宜忌(type=3时返回) |
1. 接口密钥需在聚合数据官网申请,请勿泄露给他人
2. 日期格式必须为YYYY-MM-DD,如"2024-05-20"而非"2024年5月20日"
3. 接口调用频率限制:默认1000次/秒,超出将返回限流错误
4. 仅支持1900-2100年的日期查询,超出范围将返回参数错误
5. 若查询失败,可根据error_code排查问题,或联系技术支持
答:不计费。我们仅对调用成功的请求进行计费,您可以在后台查看详细的调用记录和计费明细。
答:充值购买的调用次数一旦生效,不支持退款。但可转让给同主体下的其他账号使用。
答:您可以在后台直接升级套餐,差价多退少补。升级后立即享受新套餐的单价和服务权益。
答:支持1900年1月1日至2100年12月31日的日期查询,超出此范围的查询将返回参数错误,此类查询不计费。
