Skip to content

快速接入 ​

照着这一页走一遍,就能发出第一个可用的请求。示例用的是站内的「必应每日一图」接口。

请求基址 ​

所有接口都挂在同一个域名下,全站强制 HTTPS:

https://api.sco1.cn

把接口路径拼在后面即可,例如 https://api.sco1.cn/Interface/BingWallpaper/?n=1。全站接口目前均为 GET 方法,参数走查询字符串。

1、选一个接口 ​

打开 接口总览,按分类浏览,或用顶部搜索输入名称、路径关键词。点进接口详情后能看到路径、参数表、请求示例、响应示例和错误码。

本页用 必应每日一图(/Interface/BingWallpaper/)演示,它没有必填参数,直接请求就能拿到结果。

站点首页的接口卡片

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

接口详情页的参数表与调试面板

如果只想按步骤截图操作,看 第一个请求。

2、看参数表 ​

参数类型必填说明
nint否返回张数,1–8,默认 1
idxint否起始偏移,0 为今天,最大 7
resstring否分辨率,默认 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 上游或服务端暂时不可用。完整清单见 响应格式与错误码。

接口数据实时读取自站点数据库