图片服务 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
请求示例
bash
# 基础请求
curl "https://www.160621.xyz/api/img?name=李慕婉"
# 指定数量
curl "https://www.160621.xyz/api/img?name=李慕婉&count=10"
# 获取全量数据
curl "https://www.160621.xyz/api/img?name=李慕婉&all=true"响应格式
成功响应
json
{
"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
}错误响应 - 缺少参数
json
{
"code": 404,
"status": "error",
"message": "缺少查询参数name",
"data": null,
"timestamp": 1736123456789
}错误响应 - 未找到图片
json
{
"code": 404,
"status": "error",
"message": "此人物未有图片",
"data": null,
"timestamp": 1736123456789
}错误响应 - 参数错误
json
{
"code": 400,
"status": "error",
"message": "count参数必须为数字",
"data": null,
"timestamp": 1736123456789
}🎲 随机图片 API
智能适配的随机图片服务,根据访问设备自动选择合适的图片。
接口信息
- 接口路径:
/img/random - 请求方法:
GET - 响应格式: 重定向到图片URL
🌅 Bing 壁纸 API
获取微软 Bing 搜索引擎的每日高清壁纸。
接口信息
- 接口路径:
/img/bing - 请求方法:
GET - 响应格式: 重定向到图片URL