# 随机背景 API

Cloudflare Workers 接口。先用 `build.py` 在 `public/` 下生成序号 `.webp` 与 `manifest.json`，再通过 `/api/random`、`/api/list` 调用。

约定：`mobile-image` 竖屏，`desketop-image` 横屏。默认响应为 302；加 `format=json` 时返回 JSON。

## 快捷链接

- `/api/list`
- `/manifest.json`
- `/mobile-image/1.webp`（示例）

## 接口说明

`GET /api/random`

按设备／方向选一个文件名，302 跳到对应图片。

    GET /api/random

`GET /api/random?format=json`

返回包含 `url` 等字段的 JSON。

    GET /api/random?format=json

`GET /api/random?mode=mobile` / `?mode=desktop`

强制使用竖屏或横屏素材目录。

    GET /api/random?mode=mobile
    GET /api/random?mode=desktop

查询参数：`mode=auto|mobile|desktop`，`orientation=portrait|landscape`，`device=mobile|desktop`，`format=redirect|json`。

## 在线预览

mode
orientation
format

当前请求

响应体

    {}