主题
常见问题
接口要收费吗
当前全站接口的单次调用费用都是 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 编码,导致参数被截断。见 参数与编码。