wallhaven API

The best wallpapers on the Net

已运营709天，收录6300张图片，接口调用757757次，图片收藏142542次。

该图源内容来自 wallhaven，经过人工逐张挑选，去芜存菁。（内容如有侵权请联系客服下架）

该图源接口正在被「拾光壁纸」Windows 版、网页版使用。如需合作使用，请联系客服洽谈：nguaduot@163.com。

wallhaven

1 开始

GET https://api.nguaduot.cn/wallhaven/v3
GET https://api.nguaduot.cn/wallhaven/today
GET https://api.nguaduot.cn/wallhaven/random
GET https://api.nguaduot.cn/wallhaven/cate/{version}

2 参数

2.1 请求参数

2.1.1 /wallhaven/v3

GET 参数 数据类型 可选值 默认值 必填 说明
catehow string photography
general
空		 空 否 大类：摄影、其他、全部（默认为全类别）
catewhat string landscape
character
living
general
空		 空 否 子类：风光、人物、生灵、其他、全部（默认为全类别）
order string date
score
random
数字		 random 否 排序：最新、趋势、随缘、种子（默认按随缘）
关于“种子”，不展开说明，请查阅“随机种子”的概念
no integer 数字 99999999 否 截止序号：用于回顾更多数据
注：当 order 值为 random 时，该参数无效
例：将返回数据中最后一条的 no 值 -1 作为下次请求的 no 值，即可获取下一页数据

Headers 参数 数据类型 可选值 默认值 必填 说明
Timeline-Client string d6pld3 无 是 来源 KEY：d6pld3 仅供测试，随时停用。如需合作使用，请联系客服洽谈：nguaduot@163.com

2.1.2 /wallhaven/today

无

2.1.3 /wallhaven/random

无

2.1.4 /wallhaven/cate/{version}

Path 参数 数据类型 可选值 默认值 必填 说明
version string v1
v2
how
what		 无 是 版本：v1 为原分类，v2、how、what 为统一分类，其中 v2 包含 how（大类）和 what（子类）

2.2 响应示例（JSON）

2.2.1 /wallhaven/v3

{
  "status": 1,
  "msg": "",
  "count": 99,
  "data": [{
    "id": "2335",
    "no": 24,
    "reldate": "2023-09-27",
    "title": "大气磅礴的群山山脉桌面壁纸",
    "story": null,
    "copyright": null,
    "tag": ",天空,,自然,,云,,雪,,户外,,景观,,山,,山峰,,山脉,,山丘,,山脊,,阿尔卑斯山脉,,冰川地貌,",
    "cateid": "deskFJ",
    "catename": "风景壁纸",
    "catehowid": "photography",
    "catehowname": "摄影",
    "catewhatid": "landscape",
    "catewhatname": "风光",
    "srcurl": "https://desk.3gbizhi.com/deskFJ/2335.html",
    "imgurl": "https://gd-hbimg.huaban.com/a3534d2bb4e96200aaa33d9a0e04bfcb2b9ebe932fca13-cYlKU7",
    "thumburl": "https://gd-hbimg.huaban.com/a3534d2bb4e96200aaa33d9a0e04bfcb2b9ebe932fca13-cYlKU7_fw480webp",
    "score": 100.0,
    "score3d": 100.0,
    "score7d": 100.0,
    "score4w": 100.0,
    "rank": 0,
    "blink": 1,
    "width": 3840,
    "height": 2400,
    "size": 3131923,
    "ext": ".jpg",
    "md5": "09f4d2d6462db7f1e941e7da998bc229",
    "timestamp": "2023-09-27 11:01:57"
  }],
  "help": ...,
  "version": "4.0.240327.5000",
  "timestamp": "2024-04-12 18:12:41"
}

2.2.2 /wallhaven/today

302 图片直链

2.2.3 /wallhaven/random

302 图片直链

2.2.4 /wallhaven/cate/how

{
  "status": 1,
  "msg": "",
  "count": 5,
  "data": [{
    "version": "how",
    "id": "general",
    "name": "其他",
    "count": 289,
    "blink": 23986,
    "score": 66696.9,
    "timestamp": "2023-06-03 00:30:10"
  }, {
    "version": "how",
    "id": "photography",
    "name": "摄影",
    "count": 181,
    "blink": 12502,
    "score": 70046.9,
    "timestamp": "2023-06-03 00:30:10"
  }],
  "version": "4.0.240327.5000",
  "timestamp": "2024-04-12 18:12:41"
}

3 请求示例

# 最新图文
GET https://api.nguaduot.cn/wallhaven/v3?order=date
# 更多图文
GET https://api.nguaduot.cn/wallhaven/v3?order=date&no=1000
# 热门图文
GET https://api.nguaduot.cn/wallhaven/v3?order=score
# 随机摄影
GET https://api.nguaduot.cn/wallhaven/v3?order=random&catehow=photography
# 今日一图（或近期随机一图）
GET https://api.nguaduot.cn/wallhaven/today
# 随机一图
GET https://api.nguaduot.cn/wallhaven/random
# 分类信息（原版）
GET https://api.nguaduot.cn/wallhaven/cate/v1
# 分类信息（统一版）
GET https://api.nguaduot.cn/wallhaven/cate/how
GET https://api.nguaduot.cn/wallhaven/cate/what

4 应用

5 全部 API

6 反馈

任何疑问或合作意向，请邮件联系客服：nguaduot@163.com

© 2021-2024 nguaduot。保留所有权利。