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=* 或 &h=*，也可組合定義寬高：&w=*&h=*。

注意：

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

2.跳轉至 Bing桌布 圖片直連

使用方法：

• 將參數拼接至 API 介面的 URL 末尾
• 支援所有 API 介面呼叫。