Skip to content

图片服务 API

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

🖼️ 服务概览

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

📋 人物图片 API

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

接口信息

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

请求参数

参数名类型必填说明示例
namestring人物名称"测试"
allboolean是否获取全量数据true
countnumber返回图片数量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

基于 EdgeOne 边缘计算平台构建