批量查询
接口信息
- 接口地址:
/batch - 请求方式:
POST - 内容类型:
application/json
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| dates | string[] | 是 | 日期数组，支持多种格式：YYYY-MM-DD（推荐）、YYYY/MM/DD、YYYYMMDD、DD/MM/YYYY、MM-DD-YYYY、MM/DD/YYYY、MMDDYYYY，可混用不同格式 |
请求示例
curl -X POST https://api.apisbo.com/holidays/batch \
-H "Content-Type: application/json" \
-d '{
"dates": ["2025-01-01", "2025-01-02", "2025-01-06"]
}'也可以混用不同格式：
curl -X POST https://api.apisbo.com/holidays/batch \
-H "Content-Type: application/json" \
-d '{
"dates": ["2025-01-01", "2025/01/02", "20250106"]
}'响应示例
{
"code": 0,
"msg": "success",
"data": [
{
"date": "2025-01-01",
"isHoliday": true,
"isWorkday": false,
"holiday": {
"date": "2025-01-01",
"name": "元旦",
"type": "holiday"
},
"dayOfWeek": 3
},
{
"date": "2025-01-02",
"isHoliday": true,
"isWorkday": false,
"holiday": {
"date": "2025-01-02",
"name": "元旦",
"type": "holiday"
},
"dayOfWeek": 4
},
{
"date": "2025-01-06",
"isHoliday": false,
"isWorkday": true,
"holiday": null,
"dayOfWeek": 1
}
]
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码，0 表示成功 |
| msg | string | 响应消息 |
| data | array | 节假日信息数组，每个元素格式与单日查询相同 |
注意事项
- 单次请求最多支持查询 100 个日期
- 支持多种日期格式，推荐使用
YYYY-MM-DD格式 - 可以在同一个请求中混用不同的日期格式
- 所有日期都会在内部统一转换为
YYYY-MM-DD标准格式进行处理 - 响应数组顺序与请求中的日期顺序一致
最后更新于