Wallpaper API v2.0 - 使用文档

📌 基础用法

直接访问以下链接随机获取一张壁纸

🎲 🎲

混合

参数 (无)

API https://wallpaper.ospyo.com/api/v2

从所有可用源中随机选择（远程 + 本地全部混合）

🌐 🌐

远程

参数 dm

API https://wallpaper.ospyo.com/api/v2/dm

仅从 wallpaperweb/dm.json 远程源中随机选择

🌸 🌸

远程

参数 mm

API https://wallpaper.ospyo.com/api/v2/mm

仅从 wallpaperweb/mm.json 远程源中随机选择

🎮 🎮

本地

参数 game

API https://wallpaper.ospyo.com/api/v2/game

从 wallpaper/game/ 目录中随机选择一张

🌿 🌿

本地

参数 nature

API https://wallpaper.ospyo.com/api/v2/nature

从 wallpaper/nature/ 目录中随机选择一张

🎨 🎨

本地

参数 anime

API https://wallpaper.ospyo.com/api/v2/anime

从 wallpaper/anime/ 目录中随机选择一张

🔗 多选功能

使用 | , & 分隔多个数据源

🔀 🔀

远程混合

参数 dm|mm

API https://wallpaper.ospyo.com/api/v2?type=dm|mm

从 DM 和 MM 两个远程源中随机选择一个

🎯 🎯

本地混合

参数 game,nature,anime

API https://wallpaper.ospyo.com/api/v2?type=game,nature,anime

从 game、nature、anime 三个本地目录中随机选择

🌍 🌍

全部混合

参数 dm&mm&game

API https://wallpaper.ospyo.com/api/v2?type=dm&mm&game

从 DM、MM、game 中随机选择（& 与 | 效果相同）

🚫 排除功能

使用 exclude 参数排除指定数据源

🚫 🚫

排除单个

参数 exclude=game

API https://wallpaper.ospyo.com/api/v2?exclude=game

从所有源中排除 game 分类

❌ ❌

排除多个

参数 exclude=dm|mm

API https://wallpaper.ospyo.com/api/v2?exclude=dm|mm

排除 DM 和 MM，只剩本地壁纸源

🎯 🎯

选择+排除

参数 type=dm|game&exclude=game

API https://wallpaper.ospyo.com/api/v2?type=dm|game&exclude=game

从 dm 和 game 中选，但排除 game = 只剩 dm

⭐ 通配符匹配

使用 % 或 * 匹配任意字符

⭐ ⭐

前缀匹配

参数 game%

API https://wallpaper.ospyo.com/api/v2?type=game%

匹配 game、game_3d、game2024 等所有 game 开头分类

🔍 🔍

包含匹配

参数 *nature*

API https://wallpaper.ospyo.com/api/v2?type=*nature*

匹配 nature、4k_nature、beautiful_nature

🎯 🎯

组合使用

参数 dm|%game&exclude=game_old

API https://wallpaper.ospyo.com/api/v2?type=dm|%game&exclude=game_old

DM 远程 + 所有 game 类，但排除 game_old

📋 参数参考表

参数	类型	说明	示例
`type`	字符串	选择壁纸源，多个用分隔符连接	`type=dm\|mm` `type=game,nature`
`exclude`	字符串	排除壁纸源，多个用分隔符连接	`exclude=game` `exclude=dm\|mm`

分隔符	用途	示例
`\|`	管道符分隔多个源	`dm\|mm\|game`
`,`	逗号分隔多个源	`dm,mm,game`
`&`	&符号分隔（查询字符串中直接使用）	`type=dm&mm&game`
`%` 或 `*`	通配符，匹配0个或多个任意字符	`game%` `nature`

💡 完整语法示例

        # 从所有源随机

        https://wallpaper.ospyo.com/api/v2

        # 仅从 DM 远程源

        https://wallpaper.ospyo.com/api/v2/dm

        # 多选：DM 或 MM（管道符）

        https://wallpaper.ospyo.com/api/v2?type=dm|mm

        # 多选：game、nature 或 anime（逗号）

        https://wallpaper.ospyo.com/api/v2?type=game,nature,anime

        # 排除：所有源排除 mm

        https://wallpaper.ospyo.com/api/v2?exclude=mm

        # 选择 + 排除：从 dm、game、nature 中排除 game

        https://wallpaper.ospyo.com/api/v2?type=dm|game|nature&exclude=game

        # 通配符：所有 game 开头的分类 + dm

        https://wallpaper.ospyo.com/api/v2?type=dm|game%

        # 通配符 + 排除

        https://wallpaper.ospyo.com/api/v2?type=%game&exclude=game_old

📂 如何添加新数据源

🌐 📡

远程源

在 wallpaperweb/ 目录放入 xxx.json 文件
格式与 dm.json 相同，系统自动识别
访问地址：https://wallpaper.ospyo.com/api/v2/xxx

📁 🖼️

本地源

在 wallpaper/ 目录创建新文件夹并放入图片
支持 jpg jpeg png webp gif bmp
访问地址：https://wallpaper.ospyo.com/api/v2/分类名

💡 提示： 本地壁纸首次访问时会自动扫描目录并生成缓存文件（保存在 wallpaperweb/分类名_local.txt），后续访问直接读取缓存，速度极快。缓存有效期 86400 秒（24小时）。如需手动刷新缓存，删除对应 .txt 文件即可。

⚡ 性能说明： 远程源首次访问时自动将 JSON 转换为纯文本缓存（wallpaperweb/xxx_urls.txt），之后使用 file() 读取，比 json_decode 快 10 倍以上。本地壁纸直接 readfile() 输出，无跳转延迟。