用户登录

技术文章

外部链接将在新标签页打开。

随机动漫壁纸 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,每次请求随机返回图片,适合作为随机背景使用。
使用该壁纸接口有哪些注意事项?
建议在服务端缓存最近获取到的图片链接,避免频繁请求影响体验,并遵守接口的频率限制。

作者:沐小悠

本文约 3 分钟读完 · 关键词:动漫壁纸API、随机壁纸接口、壁纸API、免费图片API、动漫图片

更多文章 GET 示例接口

「」标签下的其他文章