Bing 每日一图 API 接口文档

项目概述

本项目提供 Bing 每日一图的查询接口，启动后自动拉取当日每日一图，并在每日 00:00、08:00、20:01 触发数据更新；更新后会将当日图片数据写入数据库，并下载图片至 resource/pic 目录（图片命名规则：YYYYMMDD_UHD.jpg，例如 20260101_UHD.jpg）。

通用规范

• 请求方式：所有接口均为 GET 请求
• 响应格式：统一返回 JSON 格式，响应结构包含 code（状态码）、message（提示信息）、data（业务数据）
• 状态码说明：0 表示请求成功，非 0 表示异常

---

接口 1：获取指定日期的每日一图

接口说明

查询指定日期的 Bing 每日一图信息，支持两种返回方式：JSON 数据（默认）、直接跳转至图片原地址。

请求信息

项	内容
请求方式	GET
请求地址	/api/v1/pic
接口权限	公开（无需鉴权）

请求参数

参数名	类型	是否必填	默认值	取值示例	描述
date	string	否	当日	20260126	要查询的日期，格式为 YYYYMMDD，不填则返回当日的每日一图
type	string	否	空	raw	返回方式：空值/非 raw 时返回 JSON 数据；raw 时直接跳转至图片原地址

请求示例

1. 获取当日图片的 JSON 数据

   http://127.0.0.1:8080/api/v1/pic
   

2. 获取 2026-01-26 的图片 JSON 数据

   http://127.0.0.1:8080/api/v1/pic?date=20260126
   

3. 直接跳转至 2026-01-26 的图片原地址

   http://127.0.0.1:8080/api/v1/pic?date=20260126&type=raw
   

返回示例（JSON 方式）

{
  "code": 0,
  "message": "success",
  "data": {
    "title": "巴伐利亚的瑰宝",
    "copyright": "新天鹅堡，巴伐利亚州，德国 (© www.fredconcha.com @ All Rights Reserved/Getty Images)",
    "url": "https://cn.bing.com/th?id=OHR.NeuschwansteinWinter_ZH-CN4972014681_UHD.jpg&rf=LaDigue_UHD.jpg&pid=hp&w=3840&h=2160&rs=1&c=4",
    "date": "20260126"
  }
}

返回参数说明

参数名	类型	描述
code	int	响应状态码，0 表示成功
message	string	响应提示信息
data	object	图片核心数据（成功时返回）
data.title	string	图片标题
data.copyright	string	图片版权信息
data.url	string	图片原地址（可直接访问）
data.date	string	图片对应的日期（YYYYMMDD）

---

接口 2：获取每日一图列表

接口说明

分页查询已存储的 Bing 每日一图数据列表。

请求信息

项	内容
请求方式	GET
请求地址	/api/v1/list
接口权限	公开（无需鉴权）

请求参数

参数名	类型	是否必填	默认值	取值范围	取值示例	描述
page	int	是	1	≥1	1	分页页码
limit	int	是	20	1~20	10	每页数据条数（最多 20 条）

请求示例

http://127.0.0.1:8080/api/v1/list?page=1&limit=20

返回示例

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "title": "巴伐利亚的瑰宝",
      "copyright": "新天鹅堡，巴伐利亚州，德国 (© www.fredconcha.com @ All Rights Reserved/Getty Images)",
      "url": "https://cn.bing.com/th?id=OHR.NeuschwansteinWinter_ZH-CN4972014681_UHD.jpg&rf=LaDigue_UHD.jpg&pid=hp&w=3840&h=2160&rs=1&c=4",
      "date": "20260126"
    }
  ],
  "totalPage": "1"
}

返回参数说明

参数名	类型	描述
code	int	响应状态码，0 表示成功
message	string	响应提示信息
data	array	图片列表数据（成功时返回）
data[].title	string	单张图片标题
data[].copyright	string	单张图片版权信息
data[].url	string	单张图片原地址
data[].date	string	单张图片对应的日期
totalPage	int	总页数

---

补充说明

1. 图片更新机制：每日 00:00、08:00、20:01 自动检查并更新当日图片数据，确保接口返回最新内容；
2. 图片存储：下载的图片文件位于 resource/pic 目录，命名规则为 YYYYMMDD_UHD.jpg；
3. 异常场景：若查询的日期无对应图片数据，接口会返回非 0 状态码及对应的提示信息（如 {"code": 1001, "message": "该日期无图片数据", "data": null}）。