Public API
这个页面说明如何获取站点的公开壁纸列表。接口会同时输出分类列表和壁纸列表，且只返回显示中并已过审的壁纸；返回类型可在后台“配置管理”的公开 API 配置中选择，也可通过 dimension 参数临时指定电脑版、手机版、头像或全部；壁纸项里包含 `category_id`、`width`、`height`、`created_at` 和可选的 `netdisk_url`，未绑定分类的壁纸会按后台默认分类输出；单张壁纸没填网盘链接时，会自动回退到后台站点配置里的默认网盘下载链接；接口不返回原图地址，图片字段会自动带上 `//当前域名/` 前缀。
Endpoint
GET /api/wallpapers.php
| 参数 | 说明 |
|---|---|
pretty |
可选。传 1 时返回格式化 JSON，便于直接在浏览器里阅读。 |
dimension |
可选。只输出指定尺寸的壁纸，取值 all、desktop、mobile、avatar；不传时使用后台配置的默认输出类型。 |
Response Fields
| 字段 | 类型 | 说明 |
|---|---|---|
ok |
boolean | 接口是否返回成功。 |
count |
integer | 当前返回的壁纸总数。 |
categories |
array | 分类列表数组。 |
categories[].id |
integer | 分类 ID。 |
categories[].name |
string | 分类名称。 |
categories[].slug |
string | 分类英文标识。 |
items |
array | 壁纸列表数组。 |
items[].id |
integer | 壁纸 ID。 |
items[].title |
string | 壁纸标题。 |
items[].category_id |
integer|null | 分类 ID。未绑定分类时会返回后台默认分类 ID；没有任何默认分类可用时才为 null。 |
items[].category_name |
string | 分类名称。未绑定分类时会返回后台默认分类名称。 |
items[].category_slug |
string | 分类英文标识。未绑定分类时会返回后台默认分类英文标识。 |
items[].status |
integer | 壁纸状态，公开接口当前只返回 1，表示这张壁纸处于显示状态。 |
items[].width |
integer|null | 壁纸原图宽度，单位为像素；旧数据尚未补全时可能为 null。 |
items[].height |
integer|null | 壁纸原图高度，单位为像素；旧数据尚未补全时可能为 null。 |
items[].created_at |
string | 壁纸添加时间，格式为 YYYY-MM-DD HH:MM:SS。 |
items[].netdisk_url |
string | 网盘下载地址。优先返回单张壁纸自己填写的值；单张未填写时，会回退到后台站点配置里的默认网盘下载链接；两边都没配置时才返回空字符串。 |
items[].thumbnail_path |
string | 缩略图完整访问地址，格式类似 //你的域名/uploads/t/xxx.jpg。 |
items[].image_path |
string | 普通图片完整访问地址，格式类似 //你的域名/uploads/n/xxx.jpg。旧数据缺失时会回退到缩略图地址。 |
Example
curl "/api/wallpapers.php?pretty=1" curl "/api/wallpapers.php?dimension=mobile"
下方示例会实时读取当前接口返回结果。
正在加载示例数据...
Notes
/api/ 目录下。