倒数日
计算从今天到指定目标日期的倒计时,返回剩余天数、周数、小时数等信息。
GET
https://api.tinyaii.cn/v1/countdown
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| date | string | 必填 | 目标日期,格式 YYYY-MM-DD | 2026-12-31 |
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| target_date | string | 目标日期 |
| days_left | integer | 剩余天数 |
| weeks_left | float | 剩余周数(保留1位小数) |
| hours_left | integer | 剩余小时数 |
| is_past | boolean | 目标日期是否已过 |
返回示例
{
"code": 200,
"message": "success",
"data": {
"target_date": "2026-12-31",
"days_left": 229,
"weeks_left": 32.7,
"hours_left": 5496,
"is_past": false
}
}
调用示例
curl "https://api.tinyaii.cn/v1/countdown?date=2026-12-31" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch("https://api.tinyaii.cn/v1/countdown?date=2026-12-31", {
headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
console.log(await res.json());import requests
resp = requests.get(
"https://api.tinyaii.cn/v1/countdown",
params={"date": "2026-12-31"},
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=10,
)
print(resp.json())把 YOUR_API_KEY 换成你的密钥即可直接运行。密钥只保存在你自己的设备上。