必应壁纸API调用教程

API 使用教程：Bing 每日壁纸接口

接口地址：https://api.wzu.me/bing.php
功能：获取指定日期和分辨率的 Bing 每日壁纸图片及元数据。

1. 请求格式

• 协议与方法：使用 HTTP/HTTPS 的 GET 请求 [[7]]。

• URL 结构：

  GET https://api.wzu.me/bing.php?day={天数}&res={分辨率}

  • 参数说明：

    • day（可选）：表示获取前几天的图片，0 为当日（默认），1 为前 1 天，以此类推 [[10]]。
    • res（可选）：图片分辨率，默认为 1920x1080。支持常见分辨率如 1366x768、800x600 等。

2. 示例请求

• 默认请求（当日图片，1920x1080）：

  curl "https://api.wzu.me/bing.php"

• 自定义请求（前 2 天的 1366x768 图片）：

  curl "https://api.wzu.me/bing.php?day=2&res=1366x768"

3. 响应示例

成功返回 JSON 格式数据，包含图片 URL 和元信息：

{
    "url": "https://bing.com/th?id=OHR.SnowyMountains_ZH-CN1234567890_1366x768.jpg",
    "copyright": "© 照片作者/机构",
    "date": "2025-03-05",
    "description": "雪山风光",
    "resolution": "1366x768"
}

• 字段说明：

  • url：图片的直接访问链接。
  • copyright：版权信息，需在使用时标注 [[2]]。
  • date：图片对应的日期（格式 YYYY-MM-DD）。
  • description：图片描述。
  • resolution：实际返回的分辨率。

4. 前端调用示例

在 HTML 中直接显示图片，使用 fetch 获取数据：

<img id="bing-wallpaper" src="loading.gif" alt="Bing每日壁纸">

<script>
// 发送 GET 请求，指定分辨率为 1366x768
fetch('https://api.wzu.me/bing.php?res=1366x768')
  .then(response => response.json())
  .then(data => {
    // 将图片 URL 赋值给 <img> 标签
    document.getElementById('bing-wallpaper').src = data.url;
  })
  .catch(error => {
    console.error('请求失败:', error);
  });
</script>

说明：通过 JavaScript 动态加载图片，需处理跨域问题（CORS），确保 API 支持跨域请求头 [[5]]。

5. PHP 调用示例

通过 PHP 获取图片并嵌入页面：

<?php
// 定义 API 地址（获取前 1 天的 800x600 图片）
$apiUrl = 'https://api.wzu.me/bing.php?day=1&res=800x600';

// 发送请求并解析 JSON 响应
$response = json_decode(file_get_contents($apiUrl), true);

// 检查返回结果
if (isset($response['url'])) {
    // 输出图片并保留版权信息
    echo "<img src='{$response['url']}' alt='{$response['description']}' 
         style='max-width:100%; height:auto;' title='{$response['copyright']}'>";
} else {
    // 处理错误
    echo "获取图片失败：{$response['error']}";
}
?>

6. 注意事项

1. 参数校验：确保 day 为非负整数，res 为支持的分辨率格式。
2. 错误处理：若返回 error 字段，需捕获并提示用户（如网络问题或参数错误）。
3. 版权遵守：使用图片时需遵守 copyright 字段的授权要求 。