Countdown/api.md · ByUsiTeam/docs

# 倒计时API使用文档

## 概述
本API提供动态倒计时展示功能，支持高度自定义参数配置，可生成具备科技感视觉效果的倒计时页面。通过URL参数可控制倒计时标题、描述和时间范围。

## 功能特性
- 支持自定义倒计时标题和描述
- 灵活设置开始/结束时间戳
- 动态进度条显示时间进度
- 响应式设计适配多端设备
- 科技感光效动画效果
- 自动完成状态检测

## API地址
```
GET https://api.www.byusi.cn/time/djs.php
```

## 请求参数

| 参数名 | 类型   | 必填 | 说明                                                                 | 默认值                  |
|--------|--------|------|----------------------------------------------------------------------|-------------------------|
| title  | string | 否   | 页面标题                                                             | "2025到2026倒计时"      |
| d      | string | 否   | 页面描述内容                                                         | "2025年到2026年的倒计时" |
| 1t     | string | 否   | 开始时间（支持strtotime格式）                                         | "2025-1-1"              |
| 2t     | string | 否   | 结束时间（支持strtotime格式）                                         | "2026-1-1"              |

## 参数示例
### 有效时间格式
- `2023-12-31 23:59:59`
- `next Monday +1 week`
- `+10 days`
- Unix时间戳（需转换为日期格式）

## 返回结果
返回HTML页面包含：
1. 动态数字倒计时显示
2. 时间进度条
3. 自定义描述内容
4. 自动更新的时间显示

## 使用示例
### 基础使用
```html
<iframe src="https://api.www.byusi.cn/time/djs.php"></iframe>
```

### 自定义参数
```html
<iframe src="https://api.www.byusi.cn/time/djs.php?title=项目上线倒计时&d=距离系统发布还有&1t=2024-6-1&2t=2024-12-31"></iframe>
```

## 效果说明
### 视觉特性
1. 赛博朋克风格UI设计
2. 动态流光边框效果
3. 数字跳动动画
4. 彩色渐变进度条
5. 自适应屏幕尺寸

### 交互特性
- 实时更新时间显示
- 进度条自动增长
- 完成时自动切换状态提示
- 数字随机光效

## 注意事项
1. 时间参数需符合PHP strtotime格式
2. 结束时间需晚于开始时间
3. 特殊字符需进行URL编码
4. 建议使用HTTPS协议调用
5. 页面禁止用户缩放操作

## 浏览器兼容性
- 现代浏览器（Chrome 90+/Firefox 88+/Safari 14+）
- 移动端主流浏览器
- 不支持IE浏览器

## 错误处理
1. 无效时间参数：自动使用默认时间
2. 参数类型错误：自动过滤HTML标签
3. 时间顺序错误：倒计时显示负值

## 样式定制建议
可通过以下方式二次开发：
1. 添加自定义CSS覆盖默认样式
2. 修改`container`类的背景效果
3. 调整`countdown-value`的字体尺寸
4. 修改`progress-bar`的渐变颜色

## 状态说明
- 进行中：显示倒计时数字和动态进度条
- 已完成：显示"计时任务已完成"提示，进度条满格

## 性能指标
- 初始化加载：<50KB
- 内存占用：<10MB
- 更新时间间隔：1秒

## 最佳实践

```html
<div class="countdown-wrapper">
  <iframe 
    src="https://api.www.byusi.cn/time/djs.php?title=毕业倒计时&d=距离2026届毕业典礼还有&2t=2025-6-20"
    style="width: 100%; height: 400px; border: none;">
  </iframe>
</div>
```

## 技术支持
如有定制需求或异常反馈，请联系：177828525@qq.com

> 文档版本：1.2.0  
> 最后更新：2025-5-3  
> API维护团队：数字时间服务组

ByUsiTeam/docs

简介

发行版

贡献者

近期动态

ByUsiTeam/docs .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

ByUsiTeam/docs