BWPAPI 2.0 Beta

BWPAPI 2.0 Beta（BingWallpaper API）是一個正在持續更新中的接口，旨在為用戶提供一系列獲取必應壁紙的新方式。

如果你在使用過程中遇到任何疑問，歡迎來到 BingWallpaper API 節點討論。

API 接口

所有 2.0 的 API 接口都位於下面的這個前綴下：

https://wallpaperbar.com/api/

接口持續更新，用愛發電，請勿濫用。

API Rate Limit

默認情況下，每個 IP 每小時可以發起的 API 請求數被限制在 600 次。你可以在 API 返回結果的 HTTP 頭部找到 Rate Limit 信息：

X-Rate-Limit-Limit: 600

X-Rate-Limit-Reset: 1409479200

X-Rate-Limit-Remaining: 116

對於能夠被瀏覽器緩存的 API 請求，只有第一次請求時，才會消耗 Rate Limit 配額。後續的相同請求會直接從瀏覽器緩存中獲取結果，不會再次消耗配額。

下面是具體的接口訪問信息。

今日必應壁紙

可直接輸出今日必應壁紙圖片，默認參數：&setmkt=訪問者地區，&size=1920x1080

可選參數：

• 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

完整例子：

隨機必應壁紙

可隨機輸出一張必應壁紙圖片，默認參數：&size=1920x1080

可選參數：

• 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

完整例子：

指定日期必應壁紙

可輸出指定日期的必應壁紙圖片，默認參數：&setmkt=訪問者地區，&size=1920x1080

可選參數：

• 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

完整例子：

擴展用法

1.自定義 Bing壁紙 圖片寬高

使用方法：

• 將參數拼接至 API 接口的URL末尾
• 可單獨定義寬或高：&w=* or &h=*，也可組合定義寬高：&w=*&h=*。

Note:

• 自定義寬高（&w and &h）與 &size 不能同時使用，請選擇其中一種方式。

2.跳轉至 Bing壁紙 圖片直鏈

使用方法：

• 將參數拼接至 API 接口的URL末尾
• 支持所有 API 接口調用。