随机图片API接口文档

联系开发者

接口概述

从预设图库中随机返回高质量图片URL

接口地址
https://api.ihuahui.win/api/2.php
请求方式
GET
返回格式
JSON

功能说明

该API从预设的高质量图片库中随机返回一张图片的URL及相关信息。适用于需要动态展示图片的场景，如网站背景、测试数据、随机壁纸展示等。

API返回JSON格式数据，包含图片URL、尺寸、分类等信息，便于开发者灵活使用。目前图库包含35张高质量壁纸图片，将持续更新扩充。

应用场景：博客文章配图、网站随机背景、测试环境图片资源、应用程序演示数据等。支持直接在img标签中使用返回的URL。

返回格式

API返回标准化JSON格式数据，包含以下字段：

成功响应 (200)

{
  "status": "success",
  "code": 200,
  "message": "随机图片获取成功",
  "timestamp": 1697535600,
  "data": {
    "url": "https://haowallpaper.com/link/common/file/getCroppingImg/16307912795016576",
    "width": 1920,
    "height": 1080,
    "category": "wallpaper"
  },
  "total": 35
}

错误响应 (500)

{
  "status": "error",
  "code": 500,
  "message": "获取图片失败: 服务器内部错误",
  "timestamp": 1697535600
}

响应字段说明

字段名 类型 说明
status string 请求状态，success表示成功，error表示失败
code int 状态码，200表示成功，500表示服务器错误
message string 操作结果描述信息
timestamp int 响应时间戳（Unix时间）
data object 图片信息对象，成功时返回
data.url string 图片的直接访问URL
data.width int 图片宽度（像素）
data.height int 图片高度（像素）
data.category string 图片分类
total int 图库中图片的总数

示例调用

1. 基础调用

请求URL

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

返回结果

{
  "status": "success",
  "code": 200,
  "message": "随机图片获取成功",
  "timestamp": 1697535600,
  "data": {
    "url": "https://haowallpaper.com/link/common/file/getCroppingImg/16648264408354176",
    "width": 1920,
    "height": 1080,
    "category": "wallpaper"
  },
  "total": 35
}

2. 在网页中使用

HTML示例

<!-- 直接显示图片 -->
<img id="randomImage" src="" alt="随机图片" class="max-w-full">

<script>
// 获取并显示随机图片
fetch('https://api.ihuahui.win/api/2.php')
  .then(response => response.json())
  .then(data => {
    if (data.status === 'success') {
      document.getElementById('randomImage').src = data.data.url;
    }
  })
  .catch(error => {
    console.error('获取图片失败:', error);
  });
</script>

效果预览

图片预览

在线测试

点击下方按钮获取随机图片，查看API返回结果和图片预览

点击上方按钮获取随机图片...

获取图片后将在这里显示预览

图片宽度

-

图片高度

-

图片总数

-