图片服务 API

提供多种图片获取服务，包括人物图片、随机图片和 Bing 壁纸，支持智能设备适配。

🖼️ 服务概览

接口	功能	响应类型	特点
/img	根据名称获取人物图片	JSON	支持批量获取、全量获取
/img/random	获取随机适配图片	图片	自动识别设备，智能适配
/img/bing	获取 Bing 每日壁纸	图片	高清壁纸，每日更新

---

📋 人物图片 API

根据指定的人物名称获取相关图片资源。

接口信息

• 接口路径: /img
• 请求方法: GET
• 响应格式: JSON

请求参数

参数名	类型	必填	说明	示例
name	string	是	人物名称	"测试"
all	boolean	否	是否获取全量数据	true
count	number	否	返回图片数量	5

参数说明

• name: 人物名称，仅支持简体中文
• all: 设置为 true 时返回该人物的所有图片，与 count 参数互斥
• count: 返回图片数量，默认值为 6

请求示例

# 基础请求
curl "https://api.160621.xyz/v1/img?name=李慕婉"

# 指定数量
curl "https://api.160621.xyz/v1/img?name=李慕婉&count=10"

# 获取全量数据
curl "https://api.160621.xyz/v1/img?name=李慕婉&all=true"

响应格式

成功响应

{
  "code": 200,
  "status": "success",
  "message": "获取所有图片成功",
  "data": {
    "name": "测试",
    "count": 5,
    "total": 120,
    "images": [
      "https://example.com/img1.jpg",
      "https://example.com/img2.jpg",
      "https://example.com/img3.jpg",
      "https://example.com/img4.jpg",
      "https://example.com/img5.jpg"
    ]
  },
  "timestamp": 1736123456789
}

错误响应 - 缺少参数

{
  "code": 404,
  "status": "error",
  "message": "缺少查询参数name",
  "data": null,
  "timestamp": 1736123456789
}

错误响应 - 未找到图片

{
  "code": 404,
  "status": "error",
  "message": "此人物未有图片",
  "data": null,
  "timestamp": 1736123456789
}

错误响应 - 参数错误

{
  "code": 400,
  "status": "error",
  "message": "count参数必须为数字",
  "data": null,
  "timestamp": 1736123456789
}

🎲 随机图片 API

智能适配的随机图片服务，根据访问设备自动选择合适的图片。

接口信息

• 接口路径: /img/random
• 请求方法: GET
• 响应格式: 重定向到图片URL

🌅 Bing 壁纸 API

获取微软 Bing 搜索引擎的每日高清壁纸。

接口信息

• 接口路径: /img/bing
• 请求方法: GET
• 响应格式: 重定向到图片URL

---

📋 图片名称列表 API

获取图片服务的全部人物名称列表。

接口信息

• 接口路径: /img/namelist
• 请求方法: GET
• 响应格式: JSON

请求示例

curl https://api.160621.xyz/v1/img/namelist

成功响应 200

{
  "code": 200,
  "status": "success",
  "message": "获取图片名称列表成功",
  "data": {
    "李慕婉": 120,
    "测试": 30
  },
  "timestamp": 1736123456789
}

data 为 { 人物名称: 图片数量 } 的映射，来源于 KV 键 image_by_count。

---

🖼️ 360 壁纸分类 API

从 360 壁纸服务获取全部分类列表。

接口信息

• 接口路径: /img/360/categories
• 请求方法: GET
• 响应格式: JSON

请求示例

curl https://api.160621.xyz/v1/img/360/categories

成功响应 200

返回 360 壁纸的分类数据，Content-Type 为 application/json。

---

🖼️ 360 壁纸列表 API

按分类获取 360 壁纸列表。

接口信息

• 接口路径: /img/360/wallpapers
• 请求方法: GET
• 响应格式: JSON

请求参数

参数名	类型	必填	说明	示例
cid	string	是	分类 ID	4
start	number	否	起始偏移，默认 0	0

请求示例

curl "https://api.160621.xyz/v1/img/360/wallpapers?cid=4&start=0"

成功响应 200

返回 360 壁纸列表数据，每页 16 条，Content-Type 为 application/json。

错误响应

缺少 cid 参数时返回 400：

{
  "error": "Missing cid parameter"
}