倒数日

GETPOST 趣味娱乐

计算从今天到指定目标日期的倒计时,返回剩余天数、周数、小时数等信息。

GET https://api.tinyaii.cn/v1/countdown

请求参数

参数名类型必填说明示例
datestring必填目标日期,格式 YYYY-MM-DD2026-12-31

返回字段

字段类型说明
target_datestring目标日期
days_leftinteger剩余天数
weeks_leftfloat剩余周数(保留1位小数)
hours_leftinteger剩余小时数
is_pastboolean目标日期是否已过

返回示例

{
  "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 换成你的密钥即可直接运行。密钥只保存在你自己的设备上。