Skip to content

第一个请求 ​

这一页从「打开首页」开始,走完一次真实调用。所有截图都来自线上站点,没有示意图。

1、找到接口 ​

打开 api.sco1.cn 首页,接口以卡片形式列出,可以用顶部分类或搜索定位。

站点首页的接口卡片列表

也可以从 分类页 按类别浏览:

按分类浏览接口

搜索更快

按 Ctrl K(macOS 为 ⌘ K)可在文档中心内直接搜接口名称、路径和文档页面。

2、打开接口详情 ​

点任意卡片进入详情页。以「临时邮箱」为例,页面会给出:接口地址、请求示例、参数说明、响应示例、错误码,以及右侧的在线调试面板。

接口详情页:参数表与在线调试面板

注意右侧面板里有一个独立的 API Key(可选) 输入框。各接口的参数表里不会列出 key,需要时在输入框里填即可,见 鉴权与 API Key。

3、发出请求 ​

拿详情页的「请求地址」拼上参数,最简单的写法是浏览器地址栏直接访问,或者用 curl:

bash
curl "https://api.sco1.cn/Interface/BingWallpaper/?n=1"

浏览器里打开 JSON 接口会直接显示返回内容,适合快速验证:

临时邮箱接口在浏览器中的真实返回

4、确认返回结构 ​

多数接口返回统一外壳:

json
{
  "success": true,
  "code": 200,
  "message": "获取成功",
  "data": {},
  "timestamp": 1790345000
}

判断顺序:先看 HTTP 状态 → 再看 code → 最后读 data。不要把 code 和 HTTP 状态码混为一谈,也不要假设所有接口都有 data(资源型接口会直接返回图片或跳转)。

详见 响应格式与错误码。

5、用调试面板复现 ​

如果请求失败,回到详情页的在线调试面板:

  1. 在「请求参数」里逐项填值。
  2. 需要身份校验时,在独立的 API Key 输入框里填 Key。
  3. 点「发送请求」,面板会展示实际请求 URL 与返回内容。
  4. 点「复制 URL」把拼好的地址贴到自己的代码里。

这一步能区分「参数拼错」和「接口本身异常」——面板能跑通,问题就在你的调用代码里。

下一步 ​

  • 想省事:照 快速接入 复制多语言示例。
  • 参数含中文或特殊符号:看 参数与编码。
  • 想试一个完整的多步接口:临时邮箱 需要 create → list → read 三步。

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