随机动漫壁纸 API 调用教程:一次请求获取高清动漫壁纸
一句话回答
调用随机动漫壁纸 API 只需向 /api/dongman 发起一次带 apikey 的 GET 请求,即可随机获得一张高清动漫壁纸,并可通过 category、type 参数控制尺寸与返回格式。
核心要点 TL;DR
- 向 /api/dongman 发起 GET 请求即可获取随机壁纸
- apikey 必填,category 可选 desktop 或 mobile
- type 支持 image、json、text 三种返回形式
- 可在服务端缓存图片链接并遵守频率限制
接口说明#
随机动漫壁纸接口(/api/dongman)每次请求都会随机返回一张高清动漫风格壁纸,图片库覆盖桌面端与移动端尺寸,并支持按客户端自动匹配,非常适合用作网站随机背景、壁纸类应用与演示项目。
请求地址与参数#
示例说明:以下代码仅用于逻辑验证,生产环境需补充异常处理、超时与重试、日志与监控告警及降级策略。
GET https://www.api.plus/api/dongman?apikey=你的APIKEY
apikey:必填,用户中心获取的 API 密钥;category:可选,指定图片类别,desktop为桌面端、mobile为移动端,不传则根据设备自动选择;type:可选,输出类型,image直接返回图片、json返回 JSON、text返回纯文本链接。
调用示例#
直接在网页中引用(适合随机背景):
<img src="https://www.api.plus/api/dongman?apikey=你的APIKEY" alt="随机动漫壁纸">
使用 curl 保存图片:
curl "https://www.api.plus/api/dongman?apikey=你的APIKEY" -o wallpaper.jpg
返回示例(type=json)#
{
"code": 200,
"message": "success",
"data": {
"url": "https://www.api.plus/api/dongman/desktop/3c14c1b571bbbcd287d09de7386abd63.jpg",
"size": "850.65 KB",
"category": "desktop"
}
}
使用建议#
图片接口适合做成随机壁纸站、博客背景或聊天机器人图片回复。为避免频繁请求影响体验,建议在服务端缓存最近获取到的图片链接,并遵守接口的频率限制。更多接口可查看IP 查询接口与 API.PLUS网站地图。
常见问题(FAQ)
随机动漫壁纸 API 的请求地址和必填参数是什么?
请求地址为 GET https://www.api.plus/api/dongman,apikey 为必填参数,需填写用户中心获取的 API 密钥;category 与 type 为可选参数。
如何指定桌面端或移动端壁纸?
传入 category 参数,desktop 表示桌面端,mobile 表示移动端;不传时接口会根据设备自动选择。
接口的 type 参数支持哪些返回类型?
type 可选 image 直接返回图片、json 返回包含 url、size、category 的 JSON、text 返回纯文本链接。
怎样把随机动漫壁纸接口用作网页随机背景?
可直接在网页中引用接口地址并带上 apikey,每次请求随机返回图片,适合作为随机背景使用。
使用该壁纸接口有哪些注意事项?
建议在服务端缓存最近获取到的图片链接,避免频繁请求影响体验,并遵守接口的频率限制。