接口调试
Playground在浏览器内直接请求 /api/v1/*，用于验证 API Key 与接口是否正常。Key 仅保存在本机浏览器，不会上传到服务器以外的地方。
必应壁纸 API
推荐使用 OpenAPI v1（/api/v1/*）。鉴权使用 Authorization: Bearer YOUR_KEY 或 app_key；Key 格式为 tb_live_… / tb_test_…（类似 OpenAI sk-）。有 Key 的请求会计入日配额，并返回 X-RateLimit-*。
概览
公开无需 Key 即可查看能力清单与机器可读规范。
GET/api/v1
curl https://www.todaybing.com/api/v1
GET/api/v1/me 需 Key
curl -H "Authorization: Bearer YOUR_KEY" https://www.todaybing.com/api/v1/me
GET/api/v1/openapi.json
curl https://www.todaybing.com/api/v1/openapi.json
一 · 今日壁纸
免费获取今日必应高清壁纸或元数据。旧路径 /api/today 仍可用；v1 路径在携带 Key 时计入配额。
GET/api/today · /api/v1/today
| 参数 | 取值 | 必须 | 描述 |
|---|---|---|---|
size | hd / fhd / mhd / 1200p | 否 | 默认 hd（1920×1080） |
formate | json | 否 | 返回 JSON；缺省返回图片流 |
date | YYYYMMDD | 否 | 历史请用 /api/v1/history |
curl "https://www.todaybing.com/api/v1/today?formate=json&size=mhd"
二 · 未来必应壁纸
PRO · Key + 会员获取即将发布的壁纸元数据；条数随会员档位变化。
GET/api/v1/future
返回字段：title、copyright、date、image、articleUrl 等。
curl -H "Authorization: Bearer YOUR_KEY" https://www.todaybing.com/api/v1/future
三 · 历史必应壁纸（中国区）
PRO · Key + 会员按日期获取中国区历史壁纸元数据。
GET/api/v1/history
| 参数 | 取值 | 必须 | 描述 |
|---|---|---|---|
date | YYYYMMDD | 是 | 例：20230101 |
curl -H "Authorization: Bearer YOUR_KEY" "https://www.todaybing.com/api/v1/history?date=20230101"
四 · 今日全球 feeds
PRO · Key + 会员获取各区域当日最新必应元数据列表。
GET/api/v1/feeds
返回数组项含 articleUrl、area、image、copyright、title、date。
curl -H "Authorization: Bearer YOUR_KEY" https://www.todaybing.com/api/v1/feeds
旧路径 /api/future、/api/history、/api/feeds 未实现业务，请统一使用 /api/v1/*。
免费接口 /api/today 行为保持不变。