FIT2CLOUD
随机图片 API 的图标

随机图片 API

253
43

从指定存储策略与附件分组中随机返回一张图片。支持配置多条 API 路径规则,访问路径时 302 跳转到随机附件。

1.1.0
泡泡🫧 发布于

1.1.0

最新
>=2.27.0

本次新增按规则配置的定时刷新,可实现「每日一图」「每小时换图」等场景。

新功能

  • 每条规则新增「刷新方式」:每次请求随机(默认)、每分钟、每小时、每天、每周、自定义秒数
  • 周期内访问同一路径固定返回同一张图片,到达自然周期边界自动换图
    • 每天:服务器本地 0 点
    • 每周:服务器本地周一 0 点
    • 每小时 / 每分钟:本地整点 / 整分钟
  • 自定义秒数范围 1–31536000,按 Unix 时间戳对齐
  • 无状态时间窗口实现:不需要后台任务或持久化,插件重启、多实例部署结果一致
  • 旧配置无需迁移,未设置刷新方式的规则保持每次请求随机

修复与改进

  • 分钟 / 小时窗口正确处理 DST 回拨(重复小时获得不同窗口)及 UTC+5:30 等非整点时区
  • 跳过 metadata / name 异常附件,避免单条畸形数据导致整池加载失败
  • 附件名单按名称哈希排序并预计算哈希,缓存重载不影响周期内图片映射

资源下载

  • random-image-api-1.1.0.jar