主题
快速接入
照着这一页走一遍,就能发出第一个可用的请求。示例用的是站内的「必应每日一图」接口。
请求基址
所有接口都挂在同一个域名下,全站强制 HTTPS:
https://api.sco1.cn把接口路径拼在后面即可,例如 https://api.sco1.cn/Interface/BingWallpaper/?n=1。全站接口目前均为 GET 方法,参数走查询字符串。
1、选一个接口
打开 接口总览,按分类浏览,或用顶部搜索输入名称、路径关键词。点进接口详情后能看到路径、参数表、请求示例、响应示例和错误码。
本页用 必应每日一图(/Interface/BingWallpaper/)演示,它没有必填参数,直接请求就能拿到结果。

点进卡片后,详情页右侧就是调试面板,参数表和请求示例都在同一页:

如果只想按步骤截图操作,看 第一个请求。
2、看参数表
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
n | int | 否 | 返回张数,1–8,默认 1 |
idx | int | 否 | 起始偏移,0 为今天,最大 7 |
res | string | 否 | 分辨率,默认 1920x1080,可传 UHD |
关于 key 参数
参数表里不会列出 key —— 它是全站通用的身份参数,不是业务参数。站内详情页的调试面板有独立的「API Key(可选)」输入框。详见 鉴权与 API Key。
3、发出请求
curl
bash
curl "https://api.sco1.cn/Interface/BingWallpaper/?n=1"JavaScript
js
const res = await fetch('https://api.sco1.cn/Interface/BingWallpaper/?n=1')
.then(r => r.json())
if (res.code !== 200) throw new Error(res.message)
console.log(res.data.list)Python
python
import requests
res = requests.get(
'https://api.sco1.cn/Interface/BingWallpaper/',
params={'n': 1}, timeout=10
).json()
print(res['data']['list'])4、读懂响应
多数接口返回统一结构:success / code / message / data / timestamp。
json
{
"success": true,
"code": 200,
"message": "获取成功",
"data": { "count": 1, "list": [] },
"timestamp": 1790345000
}注意
少数接口(图片、音频、文件类)会直接返回资源或发生 302 跳转,不套这层 JSON 外壳。请以该接口详情页的响应示例为准。
5、处理失败
先判断 HTTP 状态和 code,再读 message。常见:400 参数错误、401/403 Key 问题、429 频率过高、502/503 上游或服务端暂时不可用。完整清单见 响应格式与错误码。