Skip to content

常见问题 ​

接口要收费吗 ​

当前全站接口的单次调用费用都是 0,也就是免费。接口详情页的「限流与费用」段会显示实际配置。

必须申请 API Key 吗 ​

大多数接口直接请求即可。Key 用于需要识别调用者身份的接口;登录后在 用户中心 查看、复制或重新生成。详见 鉴权与 API Key。

为什么返回 401 / 403 ​

401 表示 Key 无效(不存在、已被重新生成、复制时带了空格);403 表示接口要求 Key 但请求里没有。重新生成会让旧 Key 立即失效。

为什么返回 429 ​

请求频率超过限制。用指数退避重试,见 限流与配额。

数据是最新的吗 ​

不一定。依赖第三方数据源的接口通常有服务端缓存(常见 10–30 分钟),上游异常时还可能回退到上一次缓存。

参数里有中文或特殊字符怎么办 ​

查询参数要做 URL 编码:

js
const q = encodeURIComponent('你好')
fetch(`https://api.sco1.cn/Interface/Pinyin/?text=${q}`)

另外注意 & 是参数分隔符,参数值里出现它会被截断。

能在浏览器里直接调吗 ​

可以,全站强制 HTTPS,用 fetch 发起 GET 即可。若遇到浏览器跨域限制,把请求放到自己的服务端转发一层,不要在前端暴露 API Key。

为什么我拿到的不是 JSON ​

图片、音频、文件类接口可能直接返回二进制或发生 302 跳转,不套统一的 JSON 外壳。先按接口详情页的响应示例判断返回类型。

在哪里在线试调 ​

站内每个接口详情页都有在线调试面板,可直接填参数、查看实时返回,并复制生成的请求地址。用法见 在线调试面板。

临时邮箱为什么刚创建查不到邮件 ​

邮件到达需要几秒到几十秒,请轮询 action=list 而不是只查一次。token 有效期 1 小时,过期要重新 create。完整示例见 临时邮箱。

临时邮箱返回 429 怎么办 ​

上游 mail.tm 对单 IP 限 8 QPS,本站另限 20 次/分钟。短时间内连续创建会撞限流,本站会自动退避重试一次;仍失败就返回 429,请用指数退避再试,不要死循环。

临时邮箱的邮箱后缀为什么每次不一样 ​

上游域名池会轮换(例如 fldubai.com),所以不能硬编码后缀,要用 create 返回的完整 email。

为什么调试面板里没有 key 参数 ​

key 是全站通用身份参数,面板把它单独放在顶部「API Key(可选)」输入框,不混在业务参数表里。

参数传了却提示「缺少必要参数」 ​

十有八九是值里含 &、#、空格或中文却没做 URL 编码,导致参数被截断。见 参数与编码。

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