节假日查询
### 节假日查询 根据日期查询节假日安排、工作日/休息日状态等信息 ### 请求示例 `GET /v1/holiday?key=你的key&date=示例值` ### 请求参数 | 参数 | 必填 | 类型 | 说明 | |---|---|---|---| | date | 是 | string | 日期,格式 yyyy-MM-dd,须大于 2021 年,如 2026-10-01 | | detail | 否 | int | 传 1 返回详细信息 | ### 返回说明 统一响应结构 `{code, msg, data}`,`code=0` 表示成功,业务数据在 `data` 中: ```json {"code":0,"msg":"success","data":{"date":"2026-10-01","week":"四","status":{"work":false,"holiday":true},"holiday":true,"name":"国庆节"}} ```
请求参数
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
date |
是 | string | 日期,格式 yyyy-MM-dd,须大于 2021 年,如 2026-10-01 |
detail |
否 | int | 传 1 返回详细信息 |
签名算法
1. 将所有请求参数(除 sign 外)按参数名 ASCII 升序排列
2. 拼接成 key1=value1&key2=value2&... 格式
3. 在拼接串末尾追加 API密钥(apiKey),无需 & 连接
4. 对最终字符串进行 MD5 加密,取 32 位小写十六进制
响应示例
{"reason": "success", "error_code": 0, "result": {"date": "2026-10-01", "week": "四", "status": {"work": false, "holiday": true}, "holiday": true, "name": "国庆节"}}
状态码说明
| code | 说明 |
|---|---|
| 0 | 请求成功 |
| -1 | 请求失败(msg 中包含具体原因) |
订单状态
| status | 含义 | 说明 |
|---|---|---|
| 1 | 待处理 | 订单已受理,等待处理 |
| 2 | 处理中 | 订单正在充值处理中 |
| 3 | 成功 | 充值成功 |
| 4 | 失败 | 充值失败(余额会自动退回) |