本页面为 WallZG 桌面版与客户端定制的专用开发者网关。接口原生支持 C# (WPF/WinForms)、Tauri、Electron 框架直连。自带 X-API-Key 及 Cookie 鉴权、频率限制与原图 404 自动降级至 previewUrl 兜底功能。
支持分页 (?page=1&pageSize=24)、分类 (?category=computer-static-landscape) 与壁纸类型进行查询。
返回指定壁纸的完整元数据、分辨率宽度、高度及相似推荐列表。
专为桌面客户端一键壁纸设置定制，若原图由于 404 不可用，会提供可访问的预览图作为兜底下载源。
获取最高分辨率原图，需要用户登录态或有效 X-API-Key。
using System.Net.Http;
using System.Threading.Tasks;
public async Task SetWallpaperAsync(int wallpaperId)
{
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("User-Agent", "WallZG-Client/1.0");
client.DefaultRequestHeaders.Add("X-API-Key", "您的API-Key");
string url = $"https://api.wallzg.com/wallpapers/{wallpaperId}/set-wallpaper";
string json = await client.GetStringAsync(url);
// 解析 json.data.setWallpaperUrl 后下载并设置壁纸
}
本接口策略支持通过 X-API-Key 访问。请登录 WallZG 账号以生成你的永久 API 专属凭证：
点击“发送测试请求”查看实时响应