开放API接口 - 美妙壁纸 | WallpaperBar - 每日一图,领略世界之美!

BWPAPI 2.0 Beta 

BWPAPI 2.0 Beta(BingWallpaper API)是一个正在持续更新中的接口,旨在为用户提供一系列 获取必应壁纸 的新方式。

如果你在使用过程中遇到任何疑问,欢迎来到 柒沁。

API 接口

所有 2.0 的 API 接口都位于下面的这个前缀下:

https://wallpaperbar.com/api

 接口持续更新,用爱发电,请勿滥用。

API Rate Limit

默认情况下,每个 IP 每小时可以发起的 API 请求数被限制在 600 次。你可以在 API 返回结果的 HTTP 头部找到 Rate Limit 信息:

X-Rate-Limit-Limit: 600X-Rate-Limit-Reset: 1409479200X-Rate-Limit-Remaining: 116

对于能够被浏览器缓存的 API 请求,只有第一次请求时,才会消耗 Rate Limit 配额。后续的相同请求会直接从浏览器缓存中获取结果,不会再次消耗配额。

下面是具体的接口访问信息。

今日必应壁纸

可直接输出今日必应壁纸图片,默认参数:&setmkt=访问者地区,&size=1920x1080

/go

    可选参数:

    • setmkt - 可指定地区:cn,us,gb,jp,de,fr,br,in,it,es,ca,au
    • size - 支持的值:uhd,qhd,fhd,mbl,mrk,1920x1200,1920x1080,1366x768,1280x768,1024x768,800x600,800x480,768x1280,720x1280,640x480,480x800,400x240,320x240,240x320

    完整例子:

      <img src="/go?setmkt=jp&size=mrk" alt="直接输出 日本必应 今日壁纸 带 必应标志水印">

      随机必应壁纸

      可随机输出一张必应壁纸图片,默认参数:&size=1920x1080

        /go?rand

        可选参数:

        • setmkt - 可指定地区:cn,us,gb,jp,de,fr,br,in,it,es,ca,au
        • size - 支持的值:uhd,qhd,fhd,mbl,mrk,1920x1200,1920x1080,1366x768,1280x768,1024x768,800x600,800x480,768x1280,720x1280,640x480,480x800,400x240,320x240,240x320

        完整例子:

          <img src="/go?rand&setmkt=us&size=720x1280" alt="随机输出一张 宽长 为 720x1280 的 美国必应 壁纸">

          指定日期必的应壁纸

          可输出指定日期的必应壁纸图片,默认参数:&setmkt=访问者地区,&size=1920x1080

            /go?date=*

            可选参数:

            • date - 格式:20241201(必须 yyyyMMdd 格式)
            • setmkt - 可指定地区:cn,us,gb,jp,de,fr,br,in,it,es,ca,au
            • size - 支持的值:uhd,qhd,fhd,mbl,mrk,1920x1200,1920x1080,1366x768,1280x768,1024x768,800x600,800x480,768x1280,720x1280,640x480,480x800,400x240,320x240,240x320

            完整例子:

              <img src="/go?date=20241201&setmkt=in&size=qhd" alt="输出 2024年12月01日 印度应 4K 壁纸">

              扩展用法

              1.自定义 Bing壁纸 图片宽高

              &w=*
              &h=*
              &w=*&h=*

                使用方法:

                • 将参数拼接至 API 接口的URL末尾
                • 可单独定义宽或高:&w=* or &h=*,也可组合定义宽高:&w=*&h=*。

                注意:

                • 自定义宽高(&w and &h)与 &size 不能同时使用,请选择其中一种方式。

                2.跳转至 Bing壁纸 图片直链

                  &redirect

                  使用方法:

                  • 将参数拼接至 API 接口的URL末尾
                  • 支持所有 API 接口调用。