API 文档 - 随机壁纸

随机壁纸 API 使用说明

1. 指定设备类型获取随机壁纸

请求 URL： /wallpaper?type={device_type}

请求参数：

type - 设备类型，支持值：pc 或 mobile。

示例请求：

GET /wallpaper?type=pc

示例响应：

HTTP/1.1 302 Found
Location: http://your-cdn-url/pc/random-image.jpg

2. 指定设备类型和返回数据类型获取随机壁纸

请求 URL： /wallpaper?type={device_type}&dataType={data_type}

请求参数：

type - 设备类型，支持值：pc 或 mobile。
dataType - 数据类型，支持值：json 或 url。

示例请求：

GET /wallpaper?type=pc&dataType=json

示例响应：

{
  "code": 200,
  "status": "success",
  "message": "Wallpaper URL retrieved successfully",
  "data": "https://cdn.aimiliy.top/pc/2a48fbc5e3c3424fa79a1f6fa5f9ee40.webp"
}

示例请求：

GET /wallpaper?type=pc&dataType=url

示例响应：

https://cdn.aimiliy.top/pc/random-wallpaper.webp

3. 刷新所有壁纸缓存

请求 URL： /resetCache

请求参数：无

示例请求：

GET /resetCache

示例响应：

{
  "code": 200,
  "status": "success",
  "message": "Cache initialized successfully"
}

4. 根据设备类型刷新指定路径的壁纸缓存

请求 URL：/refreshCacheByDevice?type={device_type}

请求参数：

type - 设备类型，支持值：pc 或 mobile。

示例请求：

GET /refreshCacheByDevice?type=pc

示例响应：

{
  "code": 200,
  "status": "success",
  "message": "Cache for device type 'pc' refreshed successfully"
}

5. 上传壁纸文件（同步新增对应壁纸缓存)

请求 URL： /upload

请求方法： POST

请求参数：

files - 需要上传的壁纸文件（支持多个文件）
type - 设备类型，支持 pc 或 mobile
password - 上传密码

示例请求：

POST /upload

示例响应：

{
  "code": 200,
  "status": "success",
  "message": "Files uploaded successfully",
  "data": [
    "https://cdn.aimiliy.top/pc/uploaded-image1.jpg",
    "https://cdn.aimiliy.top/mobile/uploaded-image2.jpg"
  ]
}

6. 查询指定设备（路径）下的所有壁纸

请求 URL： /selectImages?type={device_type}

请求方法： GET

请求参数：

type - 设备类型，支持 pc 或 mobile

示例请求：

GET /selectImages?type=pc

示例响应：

{
    "code": 200,
    "status": "success",
    "message": "Wallpapers retrieved successfully",
    "data": [
        "https://cdn.aimiliy.top/pc/2021-01-22 212950.webp",
        "https://cdn.aimiliy.top/pc/2KHD.webp",
        "https://cdn.aimiliy.top/pc/2a48fbc5e3c3424fa79a1f6fa5f9ee40.webp",
        "https://cdn.aimiliy.top/pc/winter snow.webp"
    ]
}

7. 根据壁纸文件名删除壁纸，同步删除对应壁纸缓存

请求 URL： /delete

请求方法： POST

请求参数：

fileName - 壁纸文件名（包含文件后缀）
type - 设备类型，支持 pc 或 mobile
password - 上传密码

示例请求：

POST /delete

示例响应：

{"code":200,"status":"success","message":"Image deleted successfully"}

上传壁纸文件（测试使用，请勿随意上传不符合的图片）

查询指定路径壁纸列表（测试使用，请勿随意删除）

选择设备类型：

预览壁纸API

下方展示通过 API 获取的随机壁纸：

换一换