栗次元

随机图片接口json参数文档

通过 URL 参数选择分类，随机返回图片链接，供开发者简易调用并部署在项目中。

单条随机 GET

返回指定分类的一条随机图片链接。

http://localhost:3000/json?pc

多条随机 GET

在分类参数后写数字，返回指定数量的随机图片链接。

http://localhost:3000/json?pc=3

参数说明

参数	说明	示例
分类名	加载中...	`?pc`
数量	给分类参数赋数字值，表示返回几条。不填写时默认返回 1 条。	`?pc=3`

直接调用（302重定向） GET

直接访问分类路径，会 302 重定向到随机图片，可直接用于 <img> 标签的 src。

http://localhost:3000/pc

效果预览（点击刷新）：

返回示例

单条随机返回格式：

{
  "code": 200,
  "category": "pc",
  "count": 1,
  "data": {
    "id": "example",
    "link": "https://t.xianyusss.top/img/example.webp"
  }
}

多条随机返回格式（data 为数组）：

{
  "code": 200,
  "category": "pc",
  "count": 3,
  "data": [
    { "id": "001", "link": "https://t.xianyusss.top/img/001.webp", "category": "pc" },
    { "id": "002", "link": "https://t.xianyusss.top/img/002.webp", "category": "pc" },
    { "id": "003", "link": "https://t.xianyusss.top/img/003.webp", "category": "pc" }
  ]
}

前端调用示例

JavaScript fetch 方式：

fetch('/json?pc')
  .then(r => r.json())
  .then(res => {
    console.log(res.data.link);
    // 直接用在 img 标签上
    // img.src = res.data.link;
  });

HTML 直接引用（最简单）：