178 lines
6.4 KiB
Markdown
178 lines
6.4 KiB
Markdown
首页
|
||
企业商务
|
||
节假日
|
||
节假日接口
|
||
139 146929
|
||
节假日正常服务支持MCP
|
||
判断指定日期是否为法定节假日、调休日或工作日，并返回薪资倍数。
|
||
会员免费・升级会员畅享160+免费接口，立即升级>>
|
||
收藏
|
||
普通会员
|
||
100次/天
|
||
高级会员
|
||
1W次/天
|
||
黄金会员
|
||
50W次/天
|
||
钻石会员
|
||
不限次数
|
||
|
||
▼ 接口文档
|
||
|
||
价格
|
||
|
||
返回示例
|
||
|
||
参考代码
|
||
|
||
MCP服务
|
||
|
||
帮助
|
||
|
||
生成小程序
|
||
查询节假日信息，接口返回节日名称类型、农历信息、上班调休、工资倍数、假期范围、拼假建议、及工作日相关信息等。通过请求参数mode还可以指定是否返回当天有关的国内外节日信息。使用前建议阅读参考文章：节假日接口增加多种查询方式
|
||
接口支持按年、按月、按日期范围和多个日期批量查询。如按年查询（type=1&date=2020）、按月查询（type=2&date=2020-10）、按日期范围查询（type=3&date=2020-11-1~2020-11-10）、按多个日期批量查询（date=2020-10-1,2020-11-12）
|
||
|
||
请注意，按年查询只返回中国官方节假日信息；按月查询如只传年月，则为从该月第一天到最后一天；按范围查询，起点和终点用波浪号~分隔；按多个日期批量查询用英文半角逗号分隔。无论哪种查询方式，单次查询所包含的总日期数不能超过31天。
|
||
|
||
daycode表示日期类型，0表示工作日、1节假日、2双休日、3调休日（需上班）。判断是否需要上班建议用isnotwork字段，其中值为0表示上班，为1表示休息。wage表示薪资倍数，周末为两倍，法定节假日当天为三倍其他两倍（按年查询时返回三倍薪资的具体日期）。
|
||
|
||
提示：info字段和daycode并非对应关系，建议仅用于日期类型标记；节日指某个具体日期（如2021年1月1号），节假日指整个假期（如2021年1月1号至3号）；节日范围宽泛（如会包含植树节、圣诞节），节假日指来自官方发布的有假节日，每年底政府公布后同步更新。
|
||
|
||
接入点列表：
|
||
|
||
节假日查询
|
||
相关资源：
|
||
|
||
节假日功能演示
|
||
节假日接口更新了，增加批量/范围按年按月查询
|
||
如何利用节假日API让日程规划更轻松
|
||
为什么节假日查询接口，按年查询返回250错误？
|
||
节假日接口数据有误，怎么回事？
|
||
节假日接口没有更新吗？
|
||
我想知道哪天是国家规定的3倍工资呢？
|
||
请问我如何知道节假日接口已经更新了下一年的数据呢?
|
||
▼ 接口信息
|
||
判断日期是否为官方节假日支持按年、按月和范围批量查询
|
||
|
||
接口地址：https://apis.tianapi.com/jiejiari/index?key={apiKey}
|
||
支持协议：http/https
|
||
请求方法：get/post
|
||
返回格式：utf-8 json
|
||
▼ 请求参数
|
||
上传文件时请使用标准表单格式 multipart/form-data
|
||
|
||
普通参数请使用默认表单格式 application/x-www-form-urlencoded
|
||
|
||
当参数值（如url、base64）包含特殊字符时，建议urlencode编码后传递
|
||
|
||
名称 类型 必须 示例值/默认值 说明
|
||
key string 是 您自己的ApiKey（注册账号后获得） API密钥
|
||
date string 是 2021-01-01 查询日期或日期范围
|
||
type int 是 0 查询类型，0批量、1按年、2按月、3范围
|
||
mode int 否 0 查询模式，为1同时返回中外特殊节日信息
|
||
▼ 返回示例
|
||
接口数据示例仅作为预览参考，请以实际测试结果为准
|
||
|
||
旧接口域名返回的数据结构和现在略有不同，请查看说明
|
||
|
||
|
||
|
||
成功调用，返回内容并产生计费：
|
||
|
||
|
||
{
|
||
"msg": "success",
|
||
"code": 200,
|
||
"result": {
|
||
"list": [
|
||
{
|
||
"end": 2,
|
||
"now": 0,
|
||
"tip": "1月1日放假，共3天。",
|
||
"date": "2021-01-01",
|
||
"info": "节假日",
|
||
"name": "元旦节",
|
||
"rest": "2020年12月28日至2020年12月31日请假四天，与周末连休可拼七天长假。",
|
||
"wage": 3,
|
||
"start": 0,
|
||
"enname": "NewYear",
|
||
"remark": [
|
||
"2021-12-26",
|
||
"2021-01-08"
|
||
],
|
||
"daycode": 1,
|
||
"holiday": "1月1号",
|
||
"weekday": 5,
|
||
"lunarday": "十八",
|
||
"vacation": [
|
||
"2021-01-01",
|
||
"2021-01-02",
|
||
"2021-01-03"
|
||
],
|
||
"cnweekday": "星期五",
|
||
"isnotwork": 1,
|
||
"lunaryear": "庚子",
|
||
"lunarmonth": "冬月"
|
||
}
|
||
]
|
||
}
|
||
}
|
||
|
||
|
||
|
||
|
||
失败调用，查看接口错误码释义：
|
||
|
||
|
||
{
|
||
"code": 150,
|
||
"msg": "API可用次数不足"
|
||
}
|
||
|
||
|
||
|
||
▼ 返回参数
|
||
公共参数指所有接口都会返回的参数，应用参数每个接口都不同
|
||
|
||
建议对返回的字段进行存在性与类型校验，可参考API安全接入指南
|
||
|
||
名称 类型 示例值 说明
|
||
公共参数
|
||
code int 200 状态码
|
||
msg string success 错误信息
|
||
result object {} 返回结果集
|
||
应用参数
|
||
end int 6 假期终点计数
|
||
now int 0 假期当前计数
|
||
tip string 10月1日至7日放假调休，共7天...... 放假提示
|
||
date string 2019-10-01 当前阳历日期
|
||
info string 节假日 文字提示，工作日、节假日、节日、双休日、调休日
|
||
name string 国庆节 节假日名称（中文）
|
||
rest string 10月8日至10月10日请假2天，与周末连休可拼11天长假。 拼假建议
|
||
wage int 3 薪资法定倍数/按年查询时为具体日期
|
||
start int 0 假期起点计数
|
||
enname string National Day 节日名称（英文）
|
||
remark array ["2021-12-26","2021-01-08"] 调休日数组
|
||
update boolean true/false 是否更新法定节假日（按年查询专有字段）
|
||
daycode int 1 日期类型，为0表示工作日、为1节假日、为2双休日、3为调休日（上班）
|
||
holiday string 10月1日 节日日期
|
||
weekday int 2 星期（数字）
|
||
lunarday string 初三 农历日
|
||
vacation array ["2021-01-01","2021-01-02","2021-01-03"] 节假日数组
|
||
cnweekday string 星期二 星期（中文）
|
||
isnotwork int 1 是否需要上班，0为工作日，1为休息日
|
||
lunaryear string 己亥 农历年
|
||
lunarmonth string 九月 农历月
|
||
▼ 接口价格
|
||
本接口为会员免费类接口，可根据业务需求选择升级会员方案>>
|
||
|
||
|
||
不同会员方案仅每日调用量等配额上限不同，数据本身无区别
|
||
|
||
|
||
会员方案 免费接口数 每日调用量 QPS 价格
|
||
普通会员 10个 100次 3 免费
|
||
高级会员 不限 1万次 20 29元/月、348元/年169元/年惠
|
||
黄金会员 不限 50万次 30 89元/月、1068元/年529元/年惠
|
||
钻石会员 不限 不限次 60 3380元/年1699元/年惠
|
||
▼ 返回状态码 |