单图、标签与收藏夹三类读取接口
搜索之外，API 还有三个数据读取端点，覆盖「由 ID 查详情」的全部场景。
单图：wallhaven.cc/api/v1/w/{id}
返回一张图的完整元数据，比搜索列表里的字段更全：多出 source（来源页）、uploader 的头像组、以及 tags 数组——每个标签带 id、name、alias、category、purity。做「点开看大图」类工具时用这个端点。
- 游客请求 NSFW 图返回 401；带
?apikey=密钥或X-API-Key请求头即可按账号权限放行。 - 短链提示：
whvn.cc/{id}是这张图的官方短链，跳转到网页详情页。
标签：wallhaven.cc/api/v1/tag/{id}
按 ID 查标签详情：名称、别名、所属类别（如 Anime & Manga）、纯度归属、创建时间。搜索时用 id:标签ID 与这个端点配套——先搜出图的标签 ID，再拉标签详情做聚合。
收藏夹：三个路径
| 路径 | 返回 |
|---|---|
wallhaven.cc/api/v1/collections?apikey=… | 自己的册列表（ID、名称、图数、公开与否） |
wallhaven.cc/api/v1/collections/{用户名} | 某用户的公开册列表 |
wallhaven.cc/api/v1/collections/{用户名}/{册ID} | 该册内的图，结构与搜索结果一致（纯度过滤仍生效） |
私有册只有本人带密钥可读——可见性规则见 收藏夹公开还是私藏，分享链接给朋友。
个人设置：wallhaven.cc/api/v1/settings?apikey=…
返回账号的浏览设置原值：缩略图尺寸、每页数量、纯度与分类开关、分辨率与比例列表、榜单范围、两张黑名单。第三方工具「同步我的偏好」读的就是它。
接下来去哪
- 参数怎么传密钥：看 每分钟 45 次的限流与两类报错。
- 搜索端点全表：看 搜索接口的参数全对照。