| 接口 | 说明 |
|---|---|
| ?action=categories | 分类列表（id/name/count） |
| ?action=list&category=4kdongman&page=1&pageSize=24 | 分页列表（items：filename/url/thumbUrl；按上传时间倒序） |
| ?action=random&category=4kdongman | 随机一张（JSON） |
| ?action=random&category=4kdongman&redirect=1 | 随机一张（302 跳转到图片） |
| ?action=file&category=4kdongman&filename=xxx.jpg | 原图输出（Cache-Control/ETag；download=1 触发下载） |
| ?action=thumb&category=4kdongman&filename=xxx.jpg&w=480 | 缩略图输出（JPEG；Cache-Control/ETag；w 建议 320/480/640） |
curl -sS "https://img.nxzlm.com/api/index.php?action=categories" curl -sS "https://img.nxzlm.com/api/index.php?action=list&category=4kdongman&page=1&pageSize=24" curl -I "https://img.nxzlm.com/api/index.php?action=thumb&category=4kdongman&filename=xxx.jpg&w=480" curl -O -J "https://img.nxzlm.com/api/index.php?action=file&category=4kdongman&filename=xxx.jpg&download=1"
async function listWallpapers(page = 1) {
const res = await fetch(`/api/index.php?action=list&category=4kdongman&page=${page}&pageSize=24`);
return res.json();
}
async function randomWallpaper() {
const res = await fetch(`/api/index.php?action=random&category=4kdongman`);
return res.json();
}
| 规则 | 说明 |
|---|---|
| 白名单 IP | 不限制 |
| 站内请求 | 不限制（站内会带请求头：X-Site-Request: 1） |
| 非白名单 + 非站内 | 仅对 JSON API（categories/list/random）限流：1 分钟最多 3 次 |
| 图片输出 | file/thumb 不限流；并带 Cache-Control/ETag/Last-Modified |