随机图片API接口文档

接口说明

该API用于随机返回服务器图片库中的一张图片链接，支持多种图片格式（jpg、png、gif、webp等），适用于需要随机展示图片的场景（如测试页面、示例展示、随机壁纸等）。

提示：每次请求将返回不同的随机图片链接

请求方式

GET 仅支持GET请求

请求URL：

https://api.ihuahui.win/api/3.php

请求参数：无（无需任何参数，直接请求即可）

返回示例

成功返回（JSON格式）：

{
  "code": 200,
  "status": "success",
  "message": "随机图片链接获取成功",
  "data": {
    "image_url": "https://api.ihuahui.win/api/images/example.jpg",
    "file_name": "example.jpg",
    "format": "jpg",
    "file_size_kb": 856.23,
    "last_modified": "2025-10-17 10:30:00"
  },
  "total_available_images": 20,
  "default_image_url": "https://api.ihuahui.win/api/2212.jpg"
}
            

字段说明：

字段名	说明
code	状态码（200表示成功）
image_url	随机图片的直接访问链接（核心字段）
file_size_kb	图片文件大小（KB）
total_available_images	可用图片总数

调用示例

1. 直接访问

在浏览器地址栏输入API地址，即可获取JSON响应：

https://api.ihuahui.win/api/3.php

2. JavaScript调用

前端页面动态获取并展示图片：

// HTML
<img id="randomImage" src="" alt="随机图片" style="max-width: 100%;">

// JavaScript
fetch('https://api.ihuahui.win/api/3.php')
  .then(response => response.json())
  .then(data => {
    if (data.code === 200) {
      // 成功获取图片链接，设置到img标签
      document.getElementById('randomImage').src = data.data.image_url;
    } else {
      // 失败时使用兜底图片
      document.getElementById('randomImage').src = data.default_image_url;
    }
  })
  .catch(error => {
    console.error('请求失败：', error);
  });
                

3. 示例展示

点击按钮加载一张随机图片：

图片将显示在这里

错误处理

当接口调用失败时，将返回错误信息：

{
  "code": 404,
  "status": "error",
  "message": "图片目录中无有效图片",
  "allowed_formats": ["jpg", "jpeg", "png", "gif", "webp"],
  "default_image_url": "https://api.ihuahui.win/api/2212.jpg"
}
            

常见错误码：

404：无有效图片（此时可使用返回的default_image_url）
500：服务器错误（图片目录不存在或无权限）