通用

节假日查询

### 节假日查询 根据日期查询节假日安排、工作日/休息日状态等信息 ### 请求示例 `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失败充值失败(余额会自动退回)